Manual Pages for UNIX Operating System command usage for man makecom_g0

Kernel Functions for Drivers                          makecom(9F)



NAME
     makecom, makecom_g0, makecom_g0_s, makecom_g1, makecom_g5  -
     make a packet for SCSI commands

SYNOPSIS
     #include 

     void makecom_g0(struct scsi_pkt *pkt, struct scsi_device *devp,
          int flag, int cmd, int addr, int cnt);


     void makecom_g0_s(struct scsi_pkt *pkt, struct scsi_device *devp,
          int flag, int cmd, int cnt, int fixbit);


     void makecom_g1(struct scsi_pkt *pkt, struct scsi_device *devp,
          int flag, int cmd, int addr, int cnt);


     void makecom_g5(struct scsi_pkt *pkt, struct scsi_device *devp,
          int flag, int cmd, int addr, int cnt);


INTERFACE LEVEL
     These interfaces are obsolete. scsi_setup_cdb(9F) should  be
     used instead.

PARAMETERS
     pkt       Pointer to an allocated scsi_pkt(9S) structure.


     devp      Pointer to the target's scsi_device(9S) structure.


     flag      Flags for the pkt_flags member.


     cmd       First byte of a group 0 or 1 or 5 SCSI CDB.


     addr      Pointer to the location of the data.


     cnt       Data transfer length in units defined by the  SCSI
               device  type.  For  sequential  devices cnt is the
               number of bytes. For block  devices,  cnt  is  the
               number of blocks.


     fixbit    Fixed bit in sequential access device commands.





SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                          makecom(9F)



DESCRIPTION
     The makecom functions initialize a packet with the specified
     command  descriptor  block,  devp  and  transport flags. The
     pkt_address, pkt_flags, and  the  command  descriptor  block
     pointed  to  by pkt_cdbp are initialized using the remaining
     arguments. Target drivers may use makecom_g0() for  Group  0
     commands   (except   for   sequential  access  devices),  or
     makecom_g0_s() for Group 0 commands  for  sequential  access
     devices,   or   makecom_g1()   for  Group  1  commands,   or
     makecom_g5() for Group 5 commands. fixbit is used by sequen-
     tial access devices for accessing fixed block sizes and sets
     the tag portion of the SCSI CDB.

CONTEXT
     These functions can be called from user, interrupt, or  ker-
     nel context.

EXAMPLES
     Example 1 Using makecom Functions

       if (blkno >= (1<<20)) {
             makecom_g1(pkt, SD_SCSI_DEVP, pflag, SCMD_WRITE_G1,
                (int) blkno, nblk);
       } else {
             makecom_g0(pkt, SD_SCSI_DEVP, pflag, SCMD_WRITE,
                (int) blkno, nblk);
       }


ATTRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Stability Level             | Obsolete                    |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5),     scsi_setup_cdb(9F),      scsi_device(9S),
     scsi_pkt(9S)


     ANSI Small Computer System Interface-2 (SCSI-2)


     Writing Device Drivers




SunOS 5.11          Last change: 16 Jan 2006                    2






Kernel Functions for Drivers                          makecom(9F)



NOTES
     The   makecom_g0(),   makecom_g0_s(),   makecom_g1(),    and
     makecom_g5() functions are obsolete and will be discontinued
     in a future release. These functions have been  replaced  by
     the scsi_setup_cdb() function. See scsi_setup_cdb(9F).


















































SunOS 5.11          Last change: 16 Jan 2006                    3