MAKECOM(9F) 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 <sys/scsi/scsi.h>

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.


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 sequential 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 kernel 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 attributes:


+----------------+-----------------+
|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

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).


January 16, 2006 MAKECOM(9F)