man/man9f/makecom.9f

         te
 Copyright (c) 2006, Sun Microsystems, Inc. , All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 MAKECOM 9F "Jan 16, 2006"
 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).