From mboxrd@z Thu Jan 1 00:00:00 1970 From: Oleksandr Shamray Subject: [patch v7 4/4] Documentation: jtag: Add ABI documentation Date: Fri, 1 Sep 2017 19:06:06 +0300 Message-ID: <1504281966-6199-5-git-send-email-oleksandrs@mellanox.com> References: <1504281966-6199-1-git-send-email-oleksandrs@mellanox.com> Return-path: In-Reply-To: <1504281966-6199-1-git-send-email-oleksandrs@mellanox.com> Sender: linux-kernel-owner@vger.kernel.org To: gregkh@linuxfoundation.org, arnd@arndb.de Cc: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, openbmc@lists.ozlabs.org, joel@jms.id.au, jiri@resnulli.us, tklauser@distanz.ch, linux-serial@vger.kernel.org, mec@shout.net, vadimp@maellanox.com, system-sw-low-level@mellanox.com, robh+dt@kernel.org, openocd-devel-owner@lists.sourceforge.net, linux-api@vger.kernel.org, davem@davemloft.net, mchehab@kernel.org, Oleksandr Shamray List-Id: linux-api@vger.kernel.org Added document that describe the ABI for JTAG class drivrer Signed-off-by: Oleksandr Shamray --- v6->v7 Comments pointed by Pavel Machek - Added jtag-cdev documentation to Documentation/ABI/testing folder --- Documentation/ABI/testing/jatg-cdev | 27 +++++++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 28 insertions(+), 0 deletions(-) create mode 100644 Documentation/ABI/testing/jatg-cdev diff --git a/Documentation/ABI/testing/jatg-cdev b/Documentation/ABI/testing/jatg-cdev new file mode 100644 index 0000000..14a3610 --- /dev/null +++ b/Documentation/ABI/testing/jatg-cdev @@ -0,0 +1,27 @@ +What: /dev/jtag[0-9]+ +Date: September 2017 +KernelVersion: 4.14 +Contact: oleksandrs@mellanox.com +Description: + The character device files /dev/jtag* are the interface + between JTAG master interfase and userspace. + + The ioctl(2)-based ABI is defined and documented in + [include/uapi]. + + The following file operations are supported: + + open(2) + The argument flag currently support only one access + mode O_RDWR. + + ioctl(2) + Initiate various actions. + See the inline documentation in [include/uapi] + for descriptions of all ioctls. + + close(2) + Stops and free up the I/O contexts that was associated + with the file descriptor. + +Users: TBD \ No newline at end of file diff --git a/MAINTAINERS b/MAINTAINERS index bfdfa94..dfcf49c 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -7300,6 +7300,7 @@ F: include/linux/jtag.h F: include/uapi/linux/jtag.h F: drivers/jtag/ F: Documentation/devicetree/bindings/jtag/ +F: Documentation/ABI/testing/jtag-cdev K10TEMP HARDWARE MONITORING DRIVER M: Clemens Ladisch -- 1.7.1