From: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
To: Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
Linux Doc Mailing List <linux-doc@vger.kernel.org>
Cc: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>,
"Jonathan Corbet" <corbet@lwn.net>,
Heikki Krogerus <heikki.krogerus@linux.intel.com>,
Jonathan Cameron <Jonathan.Cameron@huawei.com>,
Oded Gabbay <oded.gabbay@gmail.com>,
Rajat Jain <rajatja@google.com>,
linux-kernel@vger.kernel.org
Subject: [PATCH v2 8/8] ABI: sysfs-bus-usb: add some missing definitions
Date: Tue, 14 Sep 2021 16:55:21 +0200 [thread overview]
Message-ID: <cecbb8be48a83da0cfb97b5ac328ebd9904ed5d6.1631630792.git.mchehab+huawei@kernel.org> (raw)
In-Reply-To: <cover.1631630792.git.mchehab+huawei@kernel.org>
There are lots of interface and endpoint properties that
are currently missing any documentation. Add a basic one
for them.
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
---
Documentation/ABI/testing/sysfs-bus-usb | 43 +++++++++++++++++++++++--
1 file changed, 41 insertions(+), 2 deletions(-)
diff --git a/Documentation/ABI/testing/sysfs-bus-usb b/Documentation/ABI/testing/sysfs-bus-usb
index 42103f0f54d6..197698ad22af 100644
--- a/Documentation/ABI/testing/sysfs-bus-usb
+++ b/Documentation/ABI/testing/sysfs-bus-usb
@@ -1,4 +1,4 @@
-What: /sys/bus/usb/devices/INTERFACE/authorized
+What: /sys/bus/usb/devices/<INTERFACE>/authorized
Date: August 2015
Description:
This allows to authorize (1) or deauthorize (0)
@@ -12,7 +12,46 @@ Description:
A deauthorized interface cannot be probed or claimed.
-What: /sys/bus/usb/devices/usbX/interface_authorized_default
+What: /sys/bus/usb/devices/<INTERFACE>/bAlternateSetting
+What: /sys/bus/usb/devices/<INTERFACE>/bcdDevice
+What: /sys/bus/usb/devices/<INTERFACE>/bConfigurationValue
+What: /sys/bus/usb/devices/<INTERFACE>/bDeviceClass
+What: /sys/bus/usb/devices/<INTERFACE>/bDeviceProtocol
+What: /sys/bus/usb/devices/<INTERFACE>/bDeviceSubClass
+What: /sys/bus/usb/devices/<INTERFACE>/bAlternateSetting
+What: /sys/bus/usb/devices/<INTERFACE>/bInterfaceClass
+What: /sys/bus/usb/devices/<INTERFACE>/bInterfaceNumber
+What: /sys/bus/usb/devices/<INTERFACE>/bInterfaceProtocol
+What: /sys/bus/usb/devices/<INTERFACE>/bInterfaceSubClass
+What: /sys/bus/usb/devices/<INTERFACE>/bmAttributes
+What: /sys/bus/usb/devices/<INTERFACE>/bMaxPacketSize0
+What: /sys/bus/usb/devices/<INTERFACE>/bMaxPower
+What: /sys/bus/usb/devices/<INTERFACE>/bNumConfigurations
+What: /sys/bus/usb/devices/<INTERFACE>/bNumEndpoints
+What: /sys/bus/usb/devices/<INTERFACE>/bNumInterfaces
+What: /sys/bus/usb/devices/<INTERFACE>/busnum
+What: /sys/bus/usb/devices/<INTERFACE>/configuration
+What: /sys/bus/usb/devices/<INTERFACE>/descriptors
+What: /sys/bus/usb/devices/<INTERFACE>/bNumEndpoints
+What: /sys/bus/usb/devices/<INTERFACE>/idProduct
+What: /sys/bus/usb/devices/<INTERFACE>/idVendor
+
+Description:
+ Contain the corresponding USB descriptors for <INTERFACE>.
+
+What: /sys/bus/usb/devices/<INTERFACE>/ep_<N>/bEndpointAddress
+What: /sys/bus/usb/devices/<INTERFACE>/ep_<N>/bInterval
+What: /sys/bus/usb/devices/<INTERFACE>/ep_<N>/bLength
+What: /sys/bus/usb/devices/<INTERFACE>/ep_<N>/bmAttributes
+What: /sys/bus/usb/devices/<INTERFACE>/ep_<N>/direction
+What: /sys/bus/usb/devices/<INTERFACE>/ep_<N>/interval
+What: /sys/bus/usb/devices/<INTERFACE>/ep_<N>/type
+What: /sys/bus/usb/devices/<INTERFACE>/ep_<N>/wMaxPacketSize
+Description:
+ Contain the corresponding USB descriptors for the USB
+ endpoint ep_<N>.
+
+What: /sys/bus/usb/devices/usb<X>/interface_authorized_default
Date: August 2015
Description:
This is used as value that determines if interfaces
--
2.31.1
prev parent reply other threads:[~2021-09-14 14:55 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-09-14 14:55 [PATCH v2 0/8] Add some missing ABI symbols Mauro Carvalho Chehab
2021-09-14 14:55 ` [PATCH v2 1/8] ABI: stable/sysfs-module: better document modules Mauro Carvalho Chehab
2021-09-14 14:55 ` [PATCH v2 2/8] ABI: stable/sysfs-module: document version and srcversion Mauro Carvalho Chehab
2021-09-14 14:55 ` [PATCH v2 3/8] ABI: testing/sysfs-module: document initstate Mauro Carvalho Chehab
2021-09-14 14:55 ` [PATCH v2 4/8] ABI: sysfs-devices-power: document some RPM statistics Mauro Carvalho Chehab
2021-09-14 14:55 ` [PATCH v2 5/8] ABI: sysfs-devices: add /dev ABI Mauro Carvalho Chehab
2021-09-14 14:55 ` [PATCH v2 6/8] ABI: sysfs-bus-pci: add documentation for modalias Mauro Carvalho Chehab
2021-09-14 18:58 ` Bjorn Helgaas
2021-09-14 14:55 ` [PATCH v2 7/8] ABI: o2cb: add an obsolete file for /sys/o2cb Mauro Carvalho Chehab
2021-09-14 14:55 ` Mauro Carvalho Chehab [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=cecbb8be48a83da0cfb97b5ac328ebd9904ed5d6.1631630792.git.mchehab+huawei@kernel.org \
--to=mchehab+huawei@kernel.org \
--cc=Jonathan.Cameron@huawei.com \
--cc=corbet@lwn.net \
--cc=gregkh@linuxfoundation.org \
--cc=heikki.krogerus@linux.intel.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=oded.gabbay@gmail.com \
--cc=rajatja@google.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).