Document that VSCSI_I2T is a non-blocking operation and can be

monitored with select(2).

1 files changed, 12 insertions, 2 deletions

diff --git a/share/man/man4/vscsi.4 b/share/man/man4/vscsi.4
index 822bdb52ab0..88e73f53022 100644
--- a/share/man/man4/vscsi.4
+++ b/share/man/man4/vscsi.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: vscsi.4,v 1.11 2014/04/22 10:25:12 dlg Exp $
+.\"	$OpenBSD: vscsi.4,v 1.12 2014/06/26 01:36:49 matthew Exp $
 .\"
 .\" Copyright (c) 2008 David Gwynne <dlg@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: April 22 2014 $
+.Dd $Mdocdate: June 26 2014 $
 .Dt VSCSI 4
 .Os
 .Sh NAME
@@ -43,6 +43,16 @@ them:
 .Bl -tag -width Ds -compact
 .It VSCSI_I2T (struct vscsi_ioc_i2t *)
 Dequeue a SCSI command.
+If no SCSI commands are available to dequeue,
+.Xr ioctl 2
+will fail and set
+.Va errno
+to
+.Dv EAGAIN .
+.Pp
+When one or more SCSI commands are available to dequeue,
+.Xr select 2
+will indicate the descriptor as ready to read.
 .Bd -literal -offset indent
 struct vscsi_ioc_i2t {
 	int			tag;