/usr/share/doc/HOWTO/de-html/DE-SCSI-Programmierung-HOWTO-8.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
 <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.65">
 <TITLE>Das Linux SCSI Programmier HOWTO: Inquiry Kommandobeispiel</TITLE>
 <LINK HREF="DE-SCSI-Programmierung-HOWTO-9.html" REL=next>
 <LINK HREF="DE-SCSI-Programmierung-HOWTO-7.html" REL=previous>
 <LINK HREF="DE-SCSI-Programmierung-HOWTO.html#toc8" REL=contents>
</HEAD>
<BODY>
<A HREF="DE-SCSI-Programmierung-HOWTO-9.html"><IMG SRC="next.png" ALT="Weiter"></A>
<A HREF="DE-SCSI-Programmierung-HOWTO-7.html"><IMG SRC="prev.png" ALT="Zurück"></A>
<A HREF="DE-SCSI-Programmierung-HOWTO.html#toc8"><IMG SRC="toc.png" ALT="Inhalt"></A>
<HR>
<H2><A NAME="s8">8.</A> <A HREF="DE-SCSI-Programmierung-HOWTO.html#toc8">Inquiry Kommandobeispiel</A></H2>

<P>Eines der elementarsten SCSI-Kommandos ist das <CODE>INQUIRY</CODE> Kommando, das
zur Identifikation des SCSI-Ger&auml;ts verwendet wird.
Hier ist die Definition aus der SCSI-2 Spezifikation
(weitere Details sind dem SCSI-2 Standard zu entnehmen).</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
                            Tabelle 44: INQUIRY Command
+=====-========-========-========-========-========-========-========-========+
|  Bit|   7    |   6    |   5    |   4    |   3    |   2    |   1    |   0    |
|Byte |        |        |        |        |        |        |        |        |
|=====+=======================================================================|
| 0   |                           Operation Code (12h)                        |
|-----+-----------------------------------------------------------------------|
| 1   | Logical Unit Number      |                  Reserved         |  EVPD  |
|-----+-----------------------------------------------------------------------|
| 2   |                           Page Code                                   |
|-----+-----------------------------------------------------------------------|
| 3   |                           Reserved                                    |
|-----+-----------------------------------------------------------------------|
| 4   |                           Allocation Length                           |
|-----+-----------------------------------------------------------------------|
| 5   |                           Control                                     |
+=============================================================================+
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Die Ausgabedaten sind dann wie folgt:
<BLOCKQUOTE><CODE>
<PRE>
                     Tabelle 45: Standard INQUIRY Data Format
+=====-========-========-========-========-========-========-========-========+
|  Bit|   7    |   6    |   5    |   4    |   3    |   2    |   1    |   0    |
|Byte |        |        |        |        |        |        |        |        |
|=====+==========================+============================================|
| 0   | Peripheral Qualifier     |           Peripheral Device Type           |
|-----+-----------------------------------------------------------------------|
| 1   |  RMB   |                  Device-Type Modifier                        |
|-----+-----------------------------------------------------------------------|
| 2   |   ISO Version   |       ECMA Version       |  ANSI-Approved Version   |
|-----+-----------------+-----------------------------------------------------|
| 3   |  AENC  | TrmIOP |     Reserved    |         Response Data Format      |
|-----+-----------------------------------------------------------------------|
| 4   |                           Additional Length (n-4)                     |
|-----+-----------------------------------------------------------------------|
| 5   |                           Reserved                                    |
|-----+-----------------------------------------------------------------------|
| 6   |                           Reserved                                    |
|-----+-----------------------------------------------------------------------|
| 7   | RelAdr | WBus32 | WBus16 |  Sync  | Linked |Reserved| CmdQue | SftRe  |
|-----+-----------------------------------------------------------------------|
| 8   | (MSB)                                                                 |
|- - -+---                        Vendor Identification                    ---|
| 15  |                                                                 (LSB) |
|-----+-----------------------------------------------------------------------|
| 16  | (MSB)                                                                 |
|- - -+---                        Product Identification                   ---|
| 31  |                                                                 (LSB) |
|-----+-----------------------------------------------------------------------|
| 32  | (MSB)                                                                 |
|- - -+---                        Product Revision Level                   ---|
| 35  |                                                                 (LSB) |
|-----+-----------------------------------------------------------------------|
| 36  |                                                                       |
|- - -+---                        Vendor Specific                          ---|
| 55  |                                                                       |
|-----+-----------------------------------------------------------------------|
| 56  |                                                                       |
|- - -+---                        Reserved                                 ---|
| 95  |                                                                       |
|=====+=======================================================================|
|     |                       Vendor-Specific Parameters                      |
|=====+=======================================================================|
| 96  |                                                                       |
|- - -+---                        Vendor Specific                          ---|
| n   |                                                                       |
+=============================================================================+
</PRE>
</CODE></BLOCKQUOTE>
</P>

<P>Das folgende Beispiel benutzt die Lowlevel-Funktion <CODE>handle_SCSI_cmd</CODE> zum
Abschicken des Inquiry SCSI Kommandos.</P>
<P>Zuerst h&auml;ngen wir den Kommandoblock an den generischen Header, dann rufen
wir <CODE>handle_SCSI_cmd</CODE> auf.  Bitte beachte, da&szlig; der Parameter f&uuml;r 
die Gr&ouml;&szlig;e
des Ausgabepuffers die Kopfstrukturgr&ouml;&szlig;e nicht beinhaltet. Nach 
Abarbeitung
des Kommandos enth&auml;lt der Ausgabepuffer die angeforderte Information, falls
kein Fehler vorlag.</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
#define INQUIRY_CMD     0x12
#define INQUIRY_CMDLEN  6
#define INQUIRY_REPLY_LEN 96
#define INQUIRY_VENDOR  8       /* Versatz zum Herstellernamen im Antwortblock */

/* Herstellernamen und Typ anfordern */
static unsigned char *Inquiry ( void )
{
  unsigned char Inqbuffer[ SCSI_OFF + INQUIRY_REPLY_LEN ];
  unsigned char cmdblk [ INQUIRY_CMDLEN ] = 
      { INQUIRY_CMD,  /* Kommando */
                  0,  /* lun/reserviert */
                  0,  /* page code */
                  0,  /* reserviert */
  INQUIRY_REPLY_LEN,  /* Allokationsl&auml;nge */
                  0 };/* reserviert/flag/link */

  memcpy( cmd + SCSI_OFF, cmdblk, sizeof(cmdblk) );

  /*
   * +------------------+
   * | struct sg_header | &lt;- cmd
   * +------------------+
   * | Kopie von cmdblk | &lt;- cmd + SCSI_OFF
   * +------------------+
   */

  if (handle_SCSI_cmd(sizeof(cmdblk), 0, cmd, 
                      sizeof(Inqbuffer) - SCSI_OFF, Inqbuffer )) {
      fprintf( stderr, "Inquiry scheiterte\n" );
      exit(2);
  }
  return (Inqbuffer + SCSI_OFF);
}
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Das oben angegebene Beispiel h&auml;lt sich an diese Struktur.
Die Inquiry-Funktion kopiert ihren Kommandoblock hinter den
generischen Kopf (durch <CODE>SCSI_OFF</CODE> gegeben). Dieser Befehl
hat keine weiteren Daten zu &uuml;bergeben.
Funktion <CODE>Handle_SCSI_cmd</CODE> erzeugt daraus die Kopfstruktur.</P>
<P>Um das Beispiel vollst&auml;ndig zu machen, implementieren wir nun noch
die Funktion <CODE>main</CODE>.</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
int main( void )
{
  fd = open(DEVICE, O_RDWR);
  if (fd &lt; 0) {
    fprintf( stderr, "Lese-Schreiberlaubnis erforderlich f&uuml;r "DEVICE".\n" 
);
    exit(1);
  }

  /* ein paar Felder des Inquiry-Ergebnisses ausgeben */
  printf( "%s\n", Inquiry() + INQUIRY_VENDOR );
  return 0;
}
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Zuerst &ouml;ffnen wir das Ger&auml;t, pr&uuml;fen auf Fehler und rufen dann das
Unterprogramm Inquiry auf. Die Ergebnisse Hersteller, Produkt und Version
werden schlie&szlig;lich in lesbarer Form ausgegeben.</P>
<P>Hinweis: Der Inquiry-Befehl liefert noch weitere Informationen, mehr als
diese kleine Programm ausgibt. Vielleicht m&ouml;chtest Du es so erweitern,
da&szlig; Ger&auml;tetyp, ANSI-Version usw. behandelt werden.
Der Ger&auml;tetyp ist zum Beispiel von besonderer Bedeutung, da er f&uuml;r 
das Ger&auml;t
den festen (minimalen) und erweiterten Befehlsumfang festlegt.
Wenn Du das nicht selbst programmieren m&ouml;chtest, gibt es auch noch das
Programm scsiinfo von Eric Youngdale. Es liefert nahezu alle Angaben zu
einem SCSI-Ger&auml;t. Du findest es per FTP unter:</P>
<P>
<BLOCKQUOTE><CODE>
<A HREF="ftp://tsx-11.mit.edu/pub/Linux/ALPHA/scsi">tsx-11.mit.edu:/pub/Linux/ALPHA/scsi</A></CODE></BLOCKQUOTE>
</P>

<HR>
<A HREF="DE-SCSI-Programmierung-HOWTO-9.html"><IMG SRC="next.png" ALT="Weiter"></A>
<A HREF="DE-SCSI-Programmierung-HOWTO-7.html"><IMG SRC="prev.png" ALT="Zurück"></A>
<A HREF="DE-SCSI-Programmierung-HOWTO.html#toc8"><IMG SRC="toc.png" ALT="Inhalt"></A>
</BODY>
</HTML>
doc-linux-de 2003.10-5 / usr / share / doc / HOWTO / de-html / DE-SCSI-Programmierung-HOWTO-8.html
