linux-usb.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Alexandre Demers <alexandre.f.demers@gmail.com>
To: valentina.manea.m@gmail.com
Cc: linux-usb@vger.kernel.org
Subject: [v2] usbip: fix protocol documentation
Date: Sun, 28 Jan 2018 02:15:14 -0500	[thread overview]
Message-ID: <20180128071514.9107-1-alexandre.f.demers@gmail.com> (raw)

While reading the document, I found what seems to be 4 mistakes:
 - 1 clarification: it seems more logical to say that the device driver on
   the client machine is for the "imported" USB device management, not for
   the "exported" devices;
 - 2 typos: "the the" and "completition -> completion";
 - 1 error in the protocol description (I think):  each device has a
   specific path, thus every exported USB device description starts at that
   field, not at the busid.

Signed-off-by: Alexandre Demers <alexandre.f.demers@gmail.com>
---
 Documentation/usb/usbip_protocol.txt | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

--
2.16.1.windows.1
--
To unsubscribe from this list: send the line "unsubscribe linux-usb" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

diff --git a/Documentation/usb/usbip_protocol.txt b/Documentation/usb/usbip_protocol.txt
index 16b6fe27284c..23527101e2ea 100644
--- a/Documentation/usb/usbip_protocol.txt
+++ b/Documentation/usb/usbip_protocol.txt
@@ -2,7 +2,7 @@ PRELIMINARY DRAFT, MAY CONTAIN MISTAKES!
 28 Jun 2011

 The USB/IP protocol follows a server/client architecture. The server exports the
-USB devices and the clients imports them. The device driver for the exported
+USB devices and the clients imports them. The device driver for the imported
 USB device runs on the client machine.

 The client may ask for the list of the exported USB devices. To get the list the
@@ -153,7 +153,7 @@ OP_REP_DEVLIST: Reply with the list of exported USB devices.
 -----------+--------+------------+---------------------------------------------------
  0x144     |        | m_0        | From now on each interface is described, all
            |        |            |   together bNumInterfaces times, with the
-           |        |            |   the following 4 fields:
+           |        |            |   following 4 fields:
 -----------+--------+------------+---------------------------------------------------
            | 1      |            | bInterfaceClass
 -----------+--------+------------+---------------------------------------------------
@@ -164,7 +164,7 @@ OP_REP_DEVLIST: Reply with the list of exported USB devices.
  0x147     | 1      |            | padding byte for alignment, shall be set to zero
 -----------+--------+------------+---------------------------------------------------
  0xC +     |        |            | The second exported USB device starts at i=1
- i*0x138 + |        |            | with the busid field.
+ i*0x138 + |        |            | with the path field.
  m_(i-1)*4 |        |            |

 OP_REQ_IMPORT: Request to import (attach) a remote USB device.
@@ -351,7 +351,7 @@ USBIP_RET_UNLINK: Reply for URB unlink
  0x10      | 4      |            | ep: endpoint number
 -----------+--------+------------+---------------------------------------------------
  0x14      | 4      |            | status: This is the value contained in the
-           |        |            |   urb->status in the URB completition handler.
+           |        |            |   urb->status in the URB completion handler.
            |        |            |   FIXME: a better explanation needed.
 -----------+--------+------------+---------------------------------------------------
  0x30      | n      |            | URB data bytes. For ISO transfers the padding

             reply	other threads:[~2018-01-28  7:15 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-01-28  7:15 Alexandre Demers [this message]
2018-01-30  8:34 [v2] usbip: fix protocol documentation Alexandre Demers

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=20180128071514.9107-1-alexandre.f.demers@gmail.com \
    --to=alexandre.f.demers@gmail.com \
    --cc=linux-usb@vger.kernel.org \
    --cc=valentina.manea.m@gmail.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).