Message ID | 27304225-c8b0-9cac-94a3-e985e45aa41a@0882a8b5-c6c3-11e9-b005-00805fc181fe.uuid.home.arpa (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Series | docs: ABI: sysfs-tty: close times are in hundredths of a second | expand |
On 24. 08. 23, 9:18, Simon Arlott wrote: > The times for close_delay and closing_wait are in hundredths of a > second, not milliseconds. Fix the documentation instead of trying > to use millisecond values (which would have to be rounded). > > Signed-off-by: Simon Arlott <simon@octiron.net> > --- > If you'd prefer, I can fold the second part of this into my previous > patch which shouldn't have documented it as milliseconds in the first > place (but I copied it from the other entry). > > Documentation/ABI/testing/sysfs-tty | 12 ++++++++---- > 1 file changed, 8 insertions(+), 4 deletions(-) > > diff --git a/Documentation/ABI/testing/sysfs-tty b/Documentation/ABI/testing/sysfs-tty > index e04e322af568..6ee878771f51 100644 > --- a/Documentation/ABI/testing/sysfs-tty > +++ b/Documentation/ABI/testing/sysfs-tty > @@ -87,7 +87,8 @@ What: /sys/class/tty/ttyS<x>/close_delay > Date: October 2012 > Contact: Alan Cox <alan@linux.intel.com> > Description: > - Show the closing delay time for this port in ms. > + Show the closing delay time for this port in hundredths > + of a second. > > These sysfs values expose the TIOCGSERIAL interface via > sysfs rather than via ioctls. > @@ -96,7 +97,8 @@ What: /sys/class/tty/ttyS<x>/closing_wait > Date: October 2012 > Contact: Alan Cox <alan@linux.intel.com> > Description: > - Show the close wait time for this port in ms. > + Show the close wait time for this port in hundredths of > + a second. > > These sysfs values expose the TIOCGSERIAL interface via > sysfs rather than via ioctls. Could you send these two hunks as a separate patch? It's correct regardless of your other patch. And I would use "centiseconds" instead, which is used (IMO) in these cases. thanks,
diff --git a/Documentation/ABI/testing/sysfs-tty b/Documentation/ABI/testing/sysfs-tty index e04e322af568..6ee878771f51 100644 --- a/Documentation/ABI/testing/sysfs-tty +++ b/Documentation/ABI/testing/sysfs-tty @@ -87,7 +87,8 @@ What: /sys/class/tty/ttyS<x>/close_delay Date: October 2012 Contact: Alan Cox <alan@linux.intel.com> Description: - Show the closing delay time for this port in ms. + Show the closing delay time for this port in hundredths + of a second. These sysfs values expose the TIOCGSERIAL interface via sysfs rather than via ioctls. @@ -96,7 +97,8 @@ What: /sys/class/tty/ttyS<x>/closing_wait Date: October 2012 Contact: Alan Cox <alan@linux.intel.com> Description: - Show the close wait time for this port in ms. + Show the close wait time for this port in hundredths of + a second. These sysfs values expose the TIOCGSERIAL interface via sysfs rather than via ioctls. @@ -166,7 +168,8 @@ What: /sys/class/tty/ttyACM0/close_delay Date: August 2023 Contact: linux-usb@vger.kernel.org Description: - Set the closing delay time for this port in ms. + Set the closing delay time for this port in hundredths of a + second. These sysfs values expose the TIOCGSERIAL interface via sysfs rather than via ioctls. @@ -175,7 +178,8 @@ What: /sys/class/tty/ttyACM0/closing_wait Date: August 2023 Contact: linux-usb@vger.kernel.org Description: - Set the close wait time for this port in ms. + Set the close wait time for this port in hundredths of a + second. These sysfs values expose the TIOCGSERIAL interface via sysfs rather than via ioctls.
The times for close_delay and closing_wait are in hundredths of a second, not milliseconds. Fix the documentation instead of trying to use millisecond values (which would have to be rounded). Signed-off-by: Simon Arlott <simon@octiron.net> --- If you'd prefer, I can fold the second part of this into my previous patch which shouldn't have documented it as milliseconds in the first place (but I copied it from the other entry). Documentation/ABI/testing/sysfs-tty | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-)