Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ sb(D4I) — UnixWare 2.01

Media Vault

Software Library

Restoration Projects

Artifacts Sought






       sb(D4I)                                                      sb(D4I)


       NAME
             sb - command block structure

       SYNOPSIS
             #include <sys/sdi.h>

       DESCRIPTION
             The sb structure defines the command block, which can be
             either an scb(D4I) structure or an sfb(D4I) structure.  The
             sb_type field indicates whether the sb structure contains an
             scb (control block) or an sfb (function block) structure.

       USAGE
             Use the sb structure when you call an SDI function that sends
             a request to a PDI device [either sdi_send(D3I) or
             sdi_icmd(D3I)].

             The method for using the sb structure is:

                1   Use the sdi_getblk function to allocate a command block

                2   Set sb_type appropriately

                3   Assign values to the members of the structure as
                    appropriate

                4   Call the appropriate function to send the data
                    structure

             See scb(D4I) and sfb(D4I) for more information on structure
             use.

             The target driver must only allocate a command block using
             sdi_getblk(D3I).

             If one sb structure is copied, the new structure must be
             processed with sdi_translate(D3I).

          Structure Members
             The sb structure is defined as follows:

                         unsigned long    sb_type;  /* Type of SDI block */
                         union{
                           struct scb     b_scb;    /* SCSI control block */
                           struct sfb     b_sfb;    /* SCSI function block */
                         }sb_b;


                           Copyright 1994 Novell, Inc.               Page 1













      sb(D4I)                                                      sb(D4I)


                        struct sense sb_sense;     /* HBA sense data */

            sb_type   indicates whether the sb_b structure is an scb or an
                      sfb.  structure.  Values may be:

                          ISCB_TYPE      sb_b is an  immediate  scb  (used
                                         with sdi_icmd).

                          SCB_TYPE       sb_b  is  an   scb   (used   with
                                         sdi_send).

                          SFB_TYPE       sb_b  is  an   sfb   (used   with
                                         sdi_icmd).

            b_scb     The SCSI control block structure.

            b_sfb     The SCSI function block structure.

            sb_sense  HBA sense  data  passed  to  the  target  driver  on
                      completion, if the command completed with an error.

      REFERENCES
            scb(D4I), sdi_getblk(D3I), sdi_icmd(D3I), sdi_send(D3I),
            sdi_translate(D3I), sfb(D4I)
























                          Copyright 1994 Novell, Inc.               Page 2








Typewritten Software • bear@typewritten.org • Edmonds, WA 98026