浏览代码

USB: Documentation/usb/anchors.txt #2

This adds Documentation for the extensions of the anchor API.

Signed-off-by: Oliver Neukum <oneukum@suse.de>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
Oliver Neukum 16 年之前
父节点
当前提交
d1b1944085
共有 1 个文件被更改,包括 17 次插入0 次删除
  1. 17 0
      Documentation/usb/anchors.txt

+ 17 - 0
Documentation/usb/anchors.txt

@@ -52,6 +52,11 @@ Therefore no guarantee is made that the URBs have been unlinked when
 the call returns. They may be unlinked later but will be unlinked in
 the call returns. They may be unlinked later but will be unlinked in
 finite time.
 finite time.
 
 
+usb_scuttle_anchored_urbs()
+---------------------------
+
+All URBs of an anchor are unanchored en masse.
+
 usb_wait_anchor_empty_timeout()
 usb_wait_anchor_empty_timeout()
 -------------------------------
 -------------------------------
 
 
@@ -59,4 +64,16 @@ This function waits for all URBs associated with an anchor to finish
 or a timeout, whichever comes first. Its return value will tell you
 or a timeout, whichever comes first. Its return value will tell you
 whether the timeout was reached.
 whether the timeout was reached.
 
 
+usb_anchor_empty()
+------------------
+
+Returns true if no URBs are associated with an anchor. Locking
+is the caller's responsibility.
+
+usb_get_from_anchor()
+---------------------
 
 
+Returns the oldest anchored URB of an anchor. The URB is unanchored
+and returned with a reference. As you may mix URBs to several
+destinations in one anchor you have no guarantee the chronologically
+first submitted URB is returned.