old-www/HOWTO/SCSI-Generic-HOWTO/x364.html

203 lines
3.6 KiB
HTML

<HTML
><HEAD
><TITLE
>info</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Linux SCSI Generic (sg) HOWTO"
HREF="index.html"><LINK
REL="UP"
TITLE="The sg_io_hdr_t structure in detail"
HREF="sg_io_hdr_t.html"><LINK
REL="PREVIOUS"
TITLE="duration"
HREF="x361.html"><LINK
REL="NEXT"
TITLE="System calls"
HREF="syscalls.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The Linux SCSI Generic (sg) HOWTO</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="x361.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 6. The sg_io_hdr_t structure in detail</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="syscalls.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="AEN364">6.22. info</H1
><P
> This value is designed to convey useful information back to the user
about the associated request. This information does not necessarily
indicate an error. Several single bit and multi-bit fields are "or-ed"
together to make this value.</P
><P
> A single bit component contained in SG_INFO_OK_MASK indicates whether
some error or status field is non-zero. If either 'masked_status',
'host_status' or 'driver_status' are non-zero then SG_INFO_CHECK is
set. The associated values are:
<P
></P
><UL
><LI
><P
> SG_INFO_OK_MASK [0x1]</P
></LI
><LI
><P
> SG_INFO_OK [0x0] no sense, host nor driver "noise"</P
></LI
><LI
><P
> SG_INFO_CHECK [0x1] something abnormal happened. In most but not all
cases, the sense buffer will be written. If the sense buffer has
not been written than 'sb_len_wr' will be zero. This flag indicates
either 'masked_status', 'host_status' or 'driver_status' is
non-zero.</P
></LI
></UL
></P
><P
> A multi bit component contained in SG_INFO_DIRECT_IO_MASK indicates
what type of data transfer has just taken place. If indirect IO (or
no data transfer) has taken place then SG_INFO_INDIRECT_IO is matched.
Note that even if direct IO was requested in 'flags' the driver may
choose to do indirect IO instead. If direct IO was requested and
performed then SG_INFO_DIRECT_IO will be matched. Currently
SG_INFO_MIXED_IO is never set. The associated values are:
<P
></P
><UL
><LI
><P
> SG_INFO_DIRECT_IO_MASK [0x6]</P
></LI
><LI
><P
> SG_INFO_INDIRECT_IO [0x0] data xfer via kernel buffers (or no xfer)</P
></LI
><LI
><P
> SG_INFO_DIRECT_IO [0x2]</P
></LI
><LI
><P
> SG_INFO_MIXED_IO [0x4] part direct, part indirect IO</P
></LI
></UL
>
The type of info is unsigned int .</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="x361.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="syscalls.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>duration</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="sg_io_hdr_t.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>System calls</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>