From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: ARC-Seal: i=1; a=rsa-sha256; t=1518847148; cv=none; d=google.com; s=arc-20160816; b=hEbKwzHoU+0eae37namzjg22mlEbL9JJuWn1eRtfPtOixKjQ/3AxamcV8zxrUafLAt Vw1+zMvg9T+Oruie/jzo3dSdpeFMxkzAxhQ7UfBPkPjKKUoZC17D/XnKkjZqAzas3pRU nh/OPqopc0Mijoo04MYh0bwQEl+5Tx51qApCMlSlDW+CsrQDx+Dcs94kDC9ZU9pRMil+ bofIVWrEqz6H6wlLvqy0VMoFgTfV+85rT4UORjlwlA+IPBHuayijWf/34t6V9ILIdXBl F7VJXjwvClrFbtt+xUrcCjOB9w6JROqVv5o3UGiyzxrOYKGeK0bRJHyqGt+4ghmII6si Swiw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=user-agent:content-disposition:mime-version:message-id:subject:cc :to:from:date:dkim-signature:arc-authentication-results; bh=B3rhD00wkhRFntxAgJaiTxOBqnemgbbzgjtcofqzOP8=; b=a/AgZbjh9TLChm+hTZ6aTG96b34EsBWPb1y+aChgArLLN+rVB8XaBeW+uNu/kZzaG+ jB4Tsmxxh8F3c6AKWH9pJ9HEyw4n3G3HF5/XnoAJbzpwM/KrfX9Flu6SynZ50yJ6aaRe JgtEeBox6iTaj1ImgGmeVNoIzfWhf1A7bWpgvFD/MWIt+uht5fUKR6No/GXmoZG/DYpc nS12DSW5Rf/j3D6eil7EurVDJM+uXF0XPd3qpAW+SJ0dYkreMT0eGgIFyb7Q0e7WN54J y1LVHnHw6Kuqx2Dt+0+O10Yo50y3CdPHOQfmpcUZxrpNN+6u+PhZdGNGx6ovcGFpHqo0 ATeg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=mhOuT/8j; spf=pass (google.com: domain of aishpant@gmail.com designates 209.85.220.65 as permitted sender) smtp.mailfrom=aishpant@gmail.com; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=mhOuT/8j; spf=pass (google.com: domain of aishpant@gmail.com designates 209.85.220.65 as permitted sender) smtp.mailfrom=aishpant@gmail.com; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com X-Google-Smtp-Source: AH8x227piZ6Tf0Z7isCBp9JPW3ni9zuZrVfQceolTk3oUa18739+wlvQSseVcDXIlgvVD7dpXt9fNg== Date: Sat, 17 Feb 2018 11:29:03 +0530 From: Aishwarya Pant To: "Ed L. Cashin" , linux-kernel@vger.kernel.org, Jonathan Corbet , Greg KH Cc: Julia Lawall Subject: [PATCH v2] aoe: document sysfs interface Message-ID: <20180217055903.GA8350@mordor.localdomain> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.9.3 (2018-01-21) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: =?utf-8?q?1592626668016122554?= X-GMAIL-MSGID: =?utf-8?q?1592626668016122554?= X-Mailing-List: linux-kernel@vger.kernel.org List-ID: Documentation has been compiled from git commit logs and descriptions in Documentation/aoe/aoe.txt. This should be useful for scripting and tracking changes in the ABI. Signed-off-by: Aishwarya Pant --- Changes in v2: - interface -> interfaces in description of netif Documentation/ABI/testing/sysfs-block-aoe | 44 +++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-block-aoe diff --git a/Documentation/ABI/testing/sysfs-block-aoe b/Documentation/ABI/testing/sysfs-block-aoe new file mode 100644 index 000000000000..6f0795f7f10c --- /dev/null +++ b/Documentation/ABI/testing/sysfs-block-aoe @@ -0,0 +1,44 @@ +What: /sys/block/etherd*/mac +Date: Apr, 2005 +KernelVersion: v2.6.12 +Contact: Ed L. Cashin +Description: + (RO) The ethernet address of the remote Ata over Ethernet (AoE) + device. + +What: /sys/block/etherd*/netif +Date: Apr, 2005 +KernelVersion: v2.6.12 +Contact: Ed L. Cashin +Description: + (RO) The name of the network interfaces on the localhost through + which we are communicating with the remote AoE device. + +What: /sys/block/etherd*/state +Date: Apr, 2005 +KernelVersion: v2.6.12 +Contact: Ed L. Cashin +Description: + (RO) Device status. The state attribute is "up" when the device + is ready for I/O and "down" if detected but unusable. The + "down,closewait" state shows that the device is still open and + cannot come up again until it has been closed. The "up,kickme" + state means that the driver wants to send more commands to the + target but found out there were already the max number of + commands waiting for a response. It will retry again after being + kicked by the periodic timer handler routine. + +What: /sys/block/etherd*/firmware-version +Date: Apr, 2005 +KernelVersion: v2.6.12 +Contact: Ed L. Cashin +Description: + (RO) Version of the firmware in the target. + +What: /sys/block/etherd*/payload +Date: Dec, 2012 +KernelVersion: v3.10 +Contact: Ed L. Cashin +Description: + (RO) The amount of user data transferred (in bytes) inside each AoE + command on the network, network headers excluded. -- 2.16.1