Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

scsi_pkt(9S)

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 addr, 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);

ARGUMENTS

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

cmd The SCSI Group 0 or 1 or 5 command. 

addr Pointer to the location of the data. 

cnt Number of bytes to transfer. 

fixbit Fixed bit in sequential access device commands. 

INTERFACE LEVEL

Solaris architecture specific (SunDDI). 

DESCRIPTION

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 the tag portion of the SCSI CDB. 

CONTEXT

These functions can be called from user or interrupt context. 

EXAMPLE

    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);
    }

SEE ALSO

scsi_pkt(9S)

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

SunOS 5.1 Writing Device Drivers

SunOS 5.2  —  Last change: 21 Dec 1991

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