scsi.h File Reference

SCSI devices. More...

#include <stdint.h>
#include <gpxe/blockdev.h>
#include <gpxe/uaccess.h>
#include <gpxe/refcnt.h>

Go to the source code of this file.

Data Structures
struct	scsi_cdb_read_10
	A SCSI "READ (10)" CDB. More...
struct	scsi_cdb_read_16
	A SCSI "READ (16)" CDB. More...
struct	scsi_cdb_write_10
	A SCSI "WRITE (10)" CDB. More...
struct	scsi_cdb_write_16
	A SCSI "WRITE (16)" CDB. More...
struct	scsi_cdb_read_capacity_10
	A SCSI "READ CAPACITY (10)" CDB. More...
struct	scsi_capacity_10
	SCSI "READ CAPACITY (10)" parameter data. More...
struct	scsi_cdb_read_capacity_16
	A SCSI "READ CAPACITY (16)" CDB. More...
struct	scsi_capacity_16
	SCSI "READ CAPACITY (16)" parameter data. More...
union	scsi_cdb
	A SCSI Command Data Block. More...
struct	scsi_command
	A SCSI command. More...
struct	scsi_lun
	A SCSI LUN. More...
struct	scsi_device
	A SCSI device. More...
Defines
#define	SCSI_OPCODE_READ_10   0x28
	READ (10).
#define	SCSI_OPCODE_READ_16   0x88
	READ (16).
#define	SCSI_OPCODE_WRITE_10   0x2a
	WRITE (10).
#define	SCSI_OPCODE_WRITE_16   0x8a
	WRITE (16).
#define	SCSI_OPCODE_READ_CAPACITY_10   0x25
	READ CAPACITY (10).
#define	SCSI_OPCODE_SERVICE_ACTION_IN   0x9e
	SERVICE ACTION IN.
#define	SCSI_SERVICE_ACTION_READ_CAPACITY_16   0x10
	READ CAPACITY (16).
#define	SCSI_FL_FUA_NV   0x02
	Force unit access to NVS.
#define	SCSI_FL_FUA   0x08
	Force unit access.
#define	SCSI_FL_DPO   0x10
	Disable cache page out.
#define	SCSI_CDB_FORMAT
	printf() format for dumping a scsi_cdb
#define	SCSI_CDB_DATA(cdb)
	printf() parameters for dumping a scsi_cdb
Functions
	FILE_LICENCE (GPL2_OR_LATER)
int	scsi_detached_command (struct scsi_device *scsi, struct scsi_command *command)
int	init_scsidev (struct scsi_device *scsi)
	Initialise SCSI device.
int	scsi_parse_lun (const char *lun_string, struct scsi_lun *lun)
	Parse SCSI LUN.
Variables
struct scsi_cdb_read_10	packed
	A SCSI "READ (10)" CDB.

---

Detailed Description

SCSI devices.

Definition in file scsi.h.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

int scsi_detached_command	(	struct scsi_device *	scsi,
		struct scsi_command *	command
	)

int init_scsidev

(

struct scsi_device *

scsi

)

Initialise SCSI device.

Parameters:

scsi

SCSI device

Return values:

rc

Return status code

Initialises a SCSI device. The scsi_device::command and scsi_device::lun fields must already be filled in. This function will configure scsi_device::blockdev, including issuing a READ CAPACITY call to determine the block size and total device size.

Definition at line 289 of file scsi.c.

References scsi_device::blockdev, block_device::blocks, DBGC, block_device::op, SCSI_MAX_DUMMY_READ_CAP, scsi_read_capacity_10(), scsi_read_capacity_16(), and strerror().

Referenced by ib_srpboot(), and iscsiboot().

                                              {
        unsigned int i;
        int rc;

        /* Issue some theoretically extraneous READ CAPACITY (10)
         * commands, solely in order to draw out the "CHECK CONDITION
         * (power-on occurred)", "CHECK CONDITION (reported LUNs data
         * has changed)" etc. that some dumb targets insist on sending
         * as an error at start of day.  The precise command that we
         * use is unimportant; we just need to provide the target with
         * an opportunity to send its responses.
         */
        for ( i = 0 ; i < SCSI_MAX_DUMMY_READ_CAP ; i++ ) {
                if ( ( rc = scsi_read_capacity_10 ( &scsi->blockdev ) ) == 0 )
                        break;
                DBGC ( scsi, "SCSI %p ignoring start-of-day error (#%d)\n",
                       scsi, ( i + 1 ) );
        }

        /* Try READ CAPACITY (10), which is a mandatory command, first. */
        scsi->blockdev.op = &scsi_operations_10;
        if ( ( rc = scsi_read_capacity_10 ( &scsi->blockdev ) ) != 0 ) {
                DBGC ( scsi, "SCSI %p could not READ CAPACITY (10): %s\n",
                       scsi, strerror ( rc ) );
                return rc;
        }

        /* If capacity range was exceeded (i.e. capacity.lba was
         * 0xffffffff, meaning that blockdev->blocks is now zero), use
         * READ CAPACITY (16) instead.  READ CAPACITY (16) is not
         * mandatory, so we can't just use it straight off.
         */
        if ( scsi->blockdev.blocks == 0 ) {
                scsi->blockdev.op = &scsi_operations_16;
                if ( ( rc = scsi_read_capacity_16 ( &scsi->blockdev ) ) != 0 ){
                        DBGC ( scsi, "SCSI %p could not READ CAPACITY (16): "
                               "%s\n", scsi, strerror ( rc ) );
                        return rc;
                }
        }

        DBGC ( scsi, "SCSI %p using READ/WRITE (%d) commands\n", scsi,
               ( ( scsi->blockdev.op == &scsi_operations_10 ) ? 10 : 16 ) );
        DBGC ( scsi, "SCSI %p capacity is %ld MB (%#llx blocks)\n", scsi,
               ( ( unsigned long ) ( scsi->blockdev.blocks >> 11 ) ),
               scsi->blockdev.blocks );

        return 0;
}

int scsi_parse_lun	(	const char *	lun_string,
		struct scsi_lun *	lun
	)

Parse SCSI LUN.

Parameters:

	lun_string	LUN string representation
	lun	LUN to fill in

Return values:

rc

Return status code

Definition at line 346 of file scsi.c.

References EINVAL, htons, memset(), strtoul(), and scsi_lun::u16.

Referenced by ib_srp_parse_lun(), and iscsi_parse_root_path().

                                                                    {
        char *p;
        int i;

        memset ( lun, 0, sizeof ( *lun ) );
        if ( lun_string ) {
                p = ( char * ) lun_string;
                for ( i = 0 ; i < 4 ; i++ ) {
                        lun->u16[i] = htons ( strtoul ( p, &p, 16 ) );
                        if ( *p == '\0' )
                                break;
                        if ( *p != '-' )
                                return -EINVAL;
                        p++;
                }
                if ( *p )
                        return -EINVAL;
        }

        return 0;
}