xref: /titanic_50/usr/src/cmd/luxadm/lux_util.c (revision 6a634c9dca3093f3922e4b7ab826d7bdf17bf78e)

/*
 * CDDL HEADER START
 *
 * 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]
 *
 * CDDL HEADER END
 */
/*
 * Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
 */



#include	<stdio.h>
#include	<unistd.h>
#include	<stdlib.h>
#include	<sys/param.h>
#include	<sys/types.h>
#include	<fcntl.h>
#include	<sys/stat.h>
#include	<string.h>
#include	<strings.h>
#include	<ctype.h>
#include	<errno.h>
#include	<assert.h>
#include	<sys/scsi/impl/uscsi.h>
#include	<sys/scsi/generic/commands.h>
#include	<sys/scsi/impl/commands.h>
#include	<sys/scsi/generic/sense.h>
#include	<sys/scsi/generic/mode.h>
#include	<sys/scsi/generic/status.h>
#include	<sys/scsi/generic/inquiry.h>
#include	<sys/scsi/adapters/scsi_vhci.h>
#include	<sys/byteorder.h>
#include	"common.h"
#include	"errorcodes.h"

#define	MAX_MODE_SENSE_LEN		0xffff
#define	MAXLEN		1000

#define	RETRY_PATHLIST	1
#define	BYTES_PER_LINE	16
#define	SCMD_UNKNOWN	0xff

#define	SCSI_VHCI	"/devices/scsi_vhci/"
#define	SLASH		"/"
#define	DEV_PREFIX	"/devices/"
#define	DEV_PREFIX_STRLEN	strlen(DEV_PREFIX)
#define	DEVICES_DIR	"/devices"

extern	char	*dtype[]; /* from adm.c */
extern	int	rand_r(unsigned int *);

static int cleanup_dotdot_path(char *path);
static int wait_random_time(void);
static char *scsi_find_command_name(int cmd);
static void scsi_printerr(struct uscsi_cmd *ucmd,
	    struct scsi_extended_sense *rq, int rqlen,
	    char msg_string[], char *err_string);
static void string_dump(char *hdr, uchar_t *src, int nbytes, int format,
	    char msg_string[]);
static int issue_uscsi_cmd(int file, struct uscsi_cmd *command, int flag);


static int
wait_random_time(void)
{
	time_t		timeval;
	struct tm	*tmbuf = NULL;
	struct timeval	tval;
	unsigned int	seed;
	int		random;
	pid_t		pid;

	/*
	 * Get the system time and use "system seconds"
	 * as 'seed' to generate a random number. Then,
	 * wait between 1/10 - 1/2 seconds before retry.
	 * Get the current process id and ex-or it with
	 * the seed so that the random number is always
	 * different even in case of multiple processes
	 * generate a random number at the same time.
	 */
	if ((timeval = time(NULL)) == -1) {
		return (errno);
	}
	if ((tmbuf = localtime(&timeval)) == NULL) {
		return (-1); /* L_LOCALTIME_ERROR */
	}

	pid = getpid();

	/* get a random number. */
	seed = (unsigned int) tmbuf->tm_sec;
	seed ^= pid;
	random = rand_r(&seed);


	random = ((random % 500) + 100) * MILLISEC;
	tval.tv_sec = random / MICROSEC;
	tval.tv_usec = random % MICROSEC;

	if (select(0, NULL, NULL, NULL, &tval) == -1) {
		return (-1); /* L_SELECT_ERROR */
	}
	return (0);
}

/*
 *		Special string dump for error message
 */
static	void
string_dump(char *hdr, uchar_t *src, int nbytes, int format, char msg_string[])
{
	int i;
	int n;
	char	*p;
	char	s[256];

	assert(format == HEX_ONLY || format == HEX_ASCII);

	(void) strcpy(s, hdr);
	for (p = s; *p; p++) {
		*p = ' ';
	}

	p = hdr;
	while (nbytes > 0) {
		(void) sprintf(&msg_string[strlen(msg_string)], "%s", p);
		p = s;
		n = MIN(nbytes, BYTES_PER_LINE);
		for (i = 0; i < n; i++) {
			(void) sprintf(&msg_string[strlen(msg_string)],
			    "%02x ", src[i] & 0xff);
		}
		if (format == HEX_ASCII) {
			for (i = BYTES_PER_LINE-n; i > 0; i--) {
				(void) sprintf(&msg_string[strlen(msg_string)],
				    "   ");
			}
			(void) sprintf(&msg_string[strlen(msg_string)],
			    "    ");
			for (i = 0; i < n; i++) {
				(void) sprintf(&msg_string[strlen(msg_string)],
				    "%c", isprint(src[i]) ? src[i] : '.');
			}
		}
		(void) sprintf(&msg_string[strlen(msg_string)], "\n");
		nbytes -= n;
		src += n;
	}
}
/*
 * Return a pointer to a string telling us the name of the command.
 */
static char *
scsi_find_command_name(int cmd)
{
	/*
	 * Names of commands.  Must have SCMD_UNKNOWN at end of list.
	 */
	struct scsi_command_name {
		int command;
		char	*name;
	} scsi_command_names[29];

	register struct scsi_command_name *c;

	scsi_command_names[0].command = SCMD_TEST_UNIT_READY;
	scsi_command_names[0].name = MSGSTR(61, "Test Unit Ready");

	scsi_command_names[1].command = SCMD_FORMAT;
	scsi_command_names[1].name = MSGSTR(110, "Format");

	scsi_command_names[2].command = SCMD_REASSIGN_BLOCK;
	scsi_command_names[2].name = MSGSTR(77, "Reassign Block");

	scsi_command_names[3].command = SCMD_READ;
	scsi_command_names[3].name = MSGSTR(27, "Read");

	scsi_command_names[4].command = SCMD_WRITE;
	scsi_command_names[4].name = MSGSTR(54, "Write");

	scsi_command_names[5].command = SCMD_READ_G1;
	scsi_command_names[5].name = MSGSTR(79, "Read(10 Byte)");

	scsi_command_names[6].command = SCMD_WRITE_G1;
	scsi_command_names[6].name = MSGSTR(51, "Write(10 Byte)");

	scsi_command_names[7].command = SCMD_MODE_SELECT;
	scsi_command_names[7].name = MSGSTR(97, "Mode Select");

	scsi_command_names[8].command = SCMD_MODE_SENSE;
	scsi_command_names[8].name = MSGSTR(95, "Mode Sense");

	scsi_command_names[9].command = SCMD_REASSIGN_BLOCK;
	scsi_command_names[9].name = MSGSTR(77, "Reassign Block");

	scsi_command_names[10].command = SCMD_REQUEST_SENSE;
	scsi_command_names[10].name = MSGSTR(74, "Request Sense");

	scsi_command_names[11].command = SCMD_READ_DEFECT_LIST;
	scsi_command_names[11].name = MSGSTR(80, "Read Defect List");

	scsi_command_names[12].command = SCMD_INQUIRY;
	scsi_command_names[12].name = MSGSTR(102, "Inquiry");

	scsi_command_names[13].command = SCMD_WRITE_BUFFER;
	scsi_command_names[13].name = MSGSTR(53, "Write Buffer");

	scsi_command_names[14].command = SCMD_READ_BUFFER;
	scsi_command_names[14].name = MSGSTR(82, "Read Buffer");

	scsi_command_names[15].command = SCMD_START_STOP;
	scsi_command_names[15].name = MSGSTR(67, "Start/Stop");

	scsi_command_names[16].command = SCMD_RESERVE;
	scsi_command_names[16].name = MSGSTR(72, "Reserve");

	scsi_command_names[17].command = SCMD_RELEASE;
	scsi_command_names[17].name = MSGSTR(75, "Release");

	scsi_command_names[18].command = SCMD_MODE_SENSE_G1;
	scsi_command_names[18].name = MSGSTR(94, "Mode Sense(10 Byte)");

	scsi_command_names[19].command = SCMD_MODE_SELECT_G1;
	scsi_command_names[19].name = MSGSTR(96, "Mode Select(10 Byte)");

	scsi_command_names[20].command = SCMD_READ_CAPACITY;
	scsi_command_names[20].name = MSGSTR(81, "Read Capacity");

	scsi_command_names[21].command = SCMD_SYNC_CACHE;
	scsi_command_names[21].name = MSGSTR(64, "Synchronize Cache");

	scsi_command_names[22].command = SCMD_READ_DEFECT_LIST;
	scsi_command_names[22].name = MSGSTR(80, "Read Defect List");

	scsi_command_names[23].command = SCMD_GDIAG;
	scsi_command_names[23].name = MSGSTR(108, "Get Diagnostic");

	scsi_command_names[24].command = SCMD_SDIAG;
	scsi_command_names[24].name = MSGSTR(69, "Set Diagnostic");

	scsi_command_names[25].command = SCMD_PERS_RESERV_IN;
	scsi_command_names[25].name = MSGSTR(10500, "Persistent Reserve In");

	scsi_command_names[26].command = SCMD_PERS_RESERV_OUT;
	scsi_command_names[26].name = MSGSTR(10501, "Persistent Reserve out");

	scsi_command_names[27].command = SCMD_LOG_SENSE;
	scsi_command_names[27].name = MSGSTR(10502, "Log Sense");

	scsi_command_names[28].command = SCMD_UNKNOWN;
	scsi_command_names[28].name = MSGSTR(25, "Unknown");


	for (c = scsi_command_names; c->command != SCMD_UNKNOWN; c++)
		if (c->command == cmd)
			break;
	return (c->name);
}


/*
 *	Function to create error message containing
 *	scsi request sense information
 */

static void
scsi_printerr(struct uscsi_cmd *ucmd, struct scsi_extended_sense *rq,
		int rqlen, char msg_string[], char *err_string)
{
	int		blkno;

	switch (rq->es_key) {
	case KEY_NO_SENSE:
		(void) sprintf(msg_string, MSGSTR(91, "No sense error"));
		break;
	case KEY_RECOVERABLE_ERROR:
		(void) sprintf(msg_string, MSGSTR(76, "Recoverable error"));
		break;
	case KEY_NOT_READY:
		(void) sprintf(msg_string,
		    MSGSTR(10503,
		    "Device Not ready. Error: Random Retry Failed: %s\n."),
		    err_string);
		break;
	case KEY_MEDIUM_ERROR:
		(void) sprintf(msg_string, MSGSTR(99, "Medium error"));
		break;
	case KEY_HARDWARE_ERROR:
		(void) sprintf(msg_string, MSGSTR(106, "Hardware error"));
		break;
	case KEY_ILLEGAL_REQUEST:
		(void) sprintf(msg_string, MSGSTR(103, "Illegal request"));
		break;
	case KEY_UNIT_ATTENTION:
		(void) sprintf(msg_string,
		    MSGSTR(10504,
		    "Unit attention."
		    "Error: Random Retry Failed.\n"));
		break;
	case KEY_WRITE_PROTECT:
		(void) sprintf(msg_string, MSGSTR(52, "Write protect error"));
		break;
	case KEY_BLANK_CHECK:
		(void) sprintf(msg_string, MSGSTR(131, "Blank check error"));
		break;
	case KEY_VENDOR_UNIQUE:
		(void) sprintf(msg_string, MSGSTR(58, "Vendor unique error"));
		break;
	case KEY_COPY_ABORTED:
		(void) sprintf(msg_string, MSGSTR(123, "Copy aborted error"));
		break;
	case KEY_ABORTED_COMMAND:
		(void) sprintf(msg_string,
		    MSGSTR(10505,
		    "Aborted command. Error: Random Retry Failed.\n"));
		break;
	case KEY_EQUAL:
		(void) sprintf(msg_string, MSGSTR(117, "Equal error"));
		break;
	case KEY_VOLUME_OVERFLOW:
		(void) sprintf(msg_string, MSGSTR(57, "Volume overflow"));
		break;
	case KEY_MISCOMPARE:
		(void) sprintf(msg_string, MSGSTR(98, "Miscompare error"));
		break;
	case KEY_RESERVED:
		(void) sprintf(msg_string, MSGSTR(10506,
		    "Reserved value found"));
		break;
	default:
		(void) sprintf(msg_string, MSGSTR(59, "Unknown error"));
		break;
	}

	(void) sprintf(&msg_string[strlen(msg_string)],
	    MSGSTR(10507, " during: %s"),
	    scsi_find_command_name(ucmd->uscsi_cdb[0]));

	if (rq->es_valid) {
		blkno = (rq->es_info_1 << 24) | (rq->es_info_2 << 16) |
		    (rq->es_info_3 << 8) | rq->es_info_4;
		(void) sprintf(&msg_string[strlen(msg_string)],
		    MSGSTR(49, ": block %d (0x%x)"), blkno, blkno);
	}

	(void) sprintf(&msg_string[strlen(msg_string)], "\n");

	if (rq->es_add_len >= 6) {
		(void) sprintf(&msg_string[strlen(msg_string)],
		    MSGSTR(132, "  Additional sense: 0x%x   "
		    "ASC Qualifier: 0x%x\n"),
		    rq->es_add_code, rq->es_qual_code);
		/*
		 * rq->es_add_info[ADD_SENSE_CODE],
		 * rq->es_add_info[ADD_SENSE_QUAL_CODE]);
		 */
	}
	if (rq->es_key == KEY_ILLEGAL_REQUEST) {
		string_dump(MSGSTR(47, " cmd:   "), (uchar_t *)ucmd,
		    sizeof (struct uscsi_cmd), HEX_ONLY, msg_string);
		string_dump(MSGSTR(48, " cdb:   "),
		    (uchar_t *)ucmd->uscsi_cdb,
		    ucmd->uscsi_cdblen, HEX_ONLY, msg_string);
	}
	string_dump(MSGSTR(43, " sense:  "),
	    (uchar_t *)rq, 8 + rq->es_add_len, HEX_ONLY, msg_string);
	rqlen = rqlen;	/* not used */
}


/*
 * Execute a command and determine the result.
 */
static int
issue_uscsi_cmd(int file, struct uscsi_cmd *command, int flag)
{
	struct scsi_extended_sense	*rqbuf;
	int				status, i, retry_cnt = 0, err;
	char				errorMsg[MAXLEN];

	/*
	 * Set function flags for driver.
	 *
	 * Set Automatic request sense enable
	 *
	 */
	command->uscsi_flags = USCSI_RQENABLE;
	command->uscsi_flags |= flag;

	/* intialize error message array */
	errorMsg[0] = '\0';

	/* print command for debug */
	if (getenv("_LUX_S_DEBUG") != NULL) {
		if ((command->uscsi_cdb == NULL) ||
		    (flag & USCSI_RESET) ||
		    (flag & USCSI_RESET_ALL)) {
			if (flag & USCSI_RESET) {
				(void) printf("  Issuing a SCSI Reset.\n");
			}
			if (flag & USCSI_RESET_ALL) {
				(void) printf("  Issuing a SCSI Reset All.\n");
			}

		} else {
			(void) printf("  Issuing the following "
			    "SCSI command: %s\n",
			    scsi_find_command_name(command->uscsi_cdb[0]));
			(void) printf("	fd=0x%x cdb=", file);
			for (i = 0; i < (int)command->uscsi_cdblen; i++) {
				(void) printf("%x ", *(command->uscsi_cdb + i));
			}
			(void) printf("\n\tlen=0x%x bufaddr=0x%x buflen=0x%x"
			    " flags=0x%x\n",
			    command->uscsi_cdblen,
			    command->uscsi_bufaddr,
			    command->uscsi_buflen, command->uscsi_flags);

			if ((command->uscsi_buflen > 0) &&
			    ((flag & USCSI_READ) == 0)) {
				(void) dump_hex_data("  Buffer data: ",
				    (uchar_t *)command->uscsi_bufaddr,
				    MIN(command->uscsi_buflen, 512), HEX_ASCII);
			}
		}
		(void) fflush(stdout);
	}


	/*
	 * Default command timeout in case command left it 0
	 */
	if (command->uscsi_timeout == 0) {
		command->uscsi_timeout = 60;
	}
	/*	Issue command - finally */

retry:
	status = ioctl(file, USCSICMD, command);
	if (status == 0 && command->uscsi_status == 0) {
		if (getenv("_LUX_S_DEBUG") != NULL) {
			if ((command->uscsi_buflen > 0) &&
			    (flag & USCSI_READ)) {
				(void) dump_hex_data("\tData read:",
				    (uchar_t *)command->uscsi_bufaddr,
				    MIN(command->uscsi_buflen, 512), HEX_ASCII);
			}
		}
		return (status);
	}
	if ((status != 0) && (command->uscsi_status == 0)) {
		if ((getenv("_LUX_S_DEBUG") != NULL) ||
		    (getenv("_LUX_ER_DEBUG") != NULL)) {
			(void) printf("Unexpected USCSICMD ioctl error: %s\n",
			    strerror(errno));
		}
		return (status);
	}

	/*
	 * Just a SCSI error, create error message
	 * Retry once for Unit Attention,
	 * Not Ready, and Aborted Command
	 */
	if ((command->uscsi_rqbuf != NULL) &&
	    (((char)command->uscsi_rqlen - (char)command->uscsi_rqresid) > 0)) {

		rqbuf = (struct scsi_extended_sense *)command->uscsi_rqbuf;

		switch (rqbuf->es_key) {
		case KEY_NOT_READY:
			if (retry_cnt++ < 1) {
				ER_DPRINTF("Note: Device Not Ready."
				    " Retrying...\n");

				if ((err = wait_random_time()) == 0) {
					goto retry;
				} else {
					return (err);
				}
			}
			break;

		case KEY_UNIT_ATTENTION:
			if (retry_cnt++ < 1) {
				ER_DPRINTF("  cmd():"
				" UNIT_ATTENTION: Retrying...\n");

				goto retry;
			}
			break;

		case KEY_ABORTED_COMMAND:
			if (retry_cnt++ < 1) {
				ER_DPRINTF("Note: Command is aborted."
				" Retrying...\n");

				goto retry;
			}
			break;
		}
		if ((getenv("_LUX_S_DEBUG") != NULL) ||
		    (getenv("_LUX_ER_DEBUG") != NULL)) {
			scsi_printerr(command,
			    (struct scsi_extended_sense *)command->uscsi_rqbuf,
			    (command->uscsi_rqlen - command->uscsi_rqresid),
			    errorMsg, strerror(errno));
		}

	} else {

		/*
		 * Retry 5 times in case of BUSY, and only
		 * once for Reservation-conflict, Command
		 * Termination and Queue Full. Wait for
		 * random amount of time (between 1/10 - 1/2 secs.)
		 * between each retry. This random wait is to avoid
		 * the multiple threads being executed at the same time
		 * and also the constraint in Photon IB, where the
		 * command queue has a depth of one command.
		 */
		switch ((uchar_t)command->uscsi_status & STATUS_MASK) {
		case STATUS_BUSY:
			if (retry_cnt++ < 5) {
				if ((err = wait_random_time()) == 0) {
					R_DPRINTF("  cmd(): No. of retries %d."
					    " STATUS_BUSY: Retrying...\n",
					    retry_cnt);
					goto retry;

				} else {
					return (err);
				}
			}
			break;

		case STATUS_RESERVATION_CONFLICT:
			if (retry_cnt++ < 1) {
				if ((err = wait_random_time()) == 0) {
					R_DPRINTF("  cmd():"
					" RESERVATION_CONFLICT:"
					" Retrying...\n");
					goto retry;

				} else {
					return (err);
				}
			}
			break;

		case STATUS_TERMINATED:
			if (retry_cnt++ < 1) {
				R_DPRINTF("Note: Command Terminated."
				    " Retrying...\n");

				if ((err = wait_random_time()) == 0) {
					goto retry;
				} else {
					return (err);
				}
			}
			break;

		case STATUS_QFULL:
			if (retry_cnt++ < 1) {
				R_DPRINTF("Note: Command Queue is full."
				" Retrying...\n");

				if ((err = wait_random_time()) == 0) {
					goto retry;
				} else {
					return (err);
				}
			}
			break;
		}

	}
	if (((getenv("_LUX_S_DEBUG") != NULL) ||
	    (getenv("_LUX_ER_DEBUG") != NULL)) &&
	    (errorMsg[0] != '\0')) {
		(void) fprintf(stdout, "  %s\n", errorMsg);
	}
	return (L_SCSI_ERROR | command->uscsi_status);
}

/*
 *		MODE SENSE USCSI command
 *
 *
 *		pc = page control field
 *		page_code = Pages to return
 */
int
scsi_mode_sense_cmd(int fd,
	uchar_t *buf_ptr,
	int buf_len,
	uchar_t pc,
	uchar_t page_code)
{
	struct uscsi_cmd	ucmd;
	/* 10 byte Mode Select cmd */
	union scsi_cdb	cdb =  {SCMD_MODE_SENSE_G1, 0, 0, 0, 0, 0, 0, 0, 0, 0};
	struct	scsi_extended_sense	sense;
	int		status;
	static	int	uscsi_count;

	if ((fd < 0) || (buf_ptr == NULL) || (buf_len < 0)) {
		return (-1); /* L_INVALID_ARG */
	}

	(void) memset(buf_ptr, 0, buf_len);
	(void) memset((char *)&ucmd, 0, sizeof (ucmd));
	/* Just for me  - a sanity check */
	if ((page_code > MODEPAGE_ALLPAGES) || (pc > 3) ||
	    (buf_len > MAX_MODE_SENSE_LEN)) {
		return (-1); /* L_ILLEGAL_MODE_SENSE_PAGE */
	}
	cdb.g1_addr3 = (pc << 6) + page_code;
	cdb.g1_count1 = buf_len>>8;
	cdb.g1_count0 = buf_len & 0xff;
	ucmd.uscsi_cdb = (caddr_t)&cdb;
	ucmd.uscsi_cdblen = CDB_GROUP1;
	ucmd.uscsi_bufaddr = (caddr_t)buf_ptr;
	ucmd.uscsi_buflen = buf_len;
	ucmd.uscsi_rqbuf = (caddr_t)&sense;
	ucmd.uscsi_rqlen = sizeof (struct  scsi_extended_sense);
	ucmd.uscsi_timeout = 120;

	status = issue_uscsi_cmd(fd, &ucmd, USCSI_READ);
	/* Bytes actually transfered */
	if (status == 0) {
		uscsi_count = buf_len - ucmd.uscsi_resid;
		S_DPRINTF("  Number of bytes read on "
		"Mode Sense 0x%x\n", uscsi_count);
		if (getenv("_LUX_D_DEBUG") != NULL) {
			(void) dump_hex_data("  Mode Sense data: ", buf_ptr,
			    uscsi_count, HEX_ASCII);
		}
	}
	return (status);
}

int
scsi_release(char *path)
{
	struct uscsi_cmd	ucmd;
	union scsi_cdb		cdb = {SCMD_RELEASE, 0, 0, 0, 0, 0};
	struct	scsi_extended_sense	sense;
	int	fd, status;

	P_DPRINTF("  scsi_release: Release: Path %s\n", path);
	if ((fd = open(path, O_NDELAY | O_RDONLY)) == -1)
		return (1);

	(void) memset((char *)&ucmd, 0, sizeof (ucmd));

	ucmd.uscsi_cdb = (caddr_t)&cdb;
	ucmd.uscsi_cdblen = CDB_GROUP0;
	ucmd.uscsi_bufaddr = NULL;
	ucmd.uscsi_buflen = 0;
	ucmd.uscsi_rqbuf = (caddr_t)&sense;
	ucmd.uscsi_rqlen = sizeof (struct  scsi_extended_sense);
	ucmd.uscsi_timeout = 60;
	status = (issue_uscsi_cmd(fd, &ucmd, 0));

	(void) close(fd);
	return (status);
}

int
scsi_reserve(char *path)
{
	struct uscsi_cmd	ucmd;
	union scsi_cdb	cdb = {SCMD_RESERVE, 0, 0, 0, 0, 0};
	struct	scsi_extended_sense	sense;
	int	fd, status;

	P_DPRINTF("  scsi_reserve: Reserve: Path %s\n", path);
	if ((fd = open(path, O_NDELAY | O_RDONLY)) == -1)
		return (1);

	(void) memset((char *)&ucmd, 0, sizeof (ucmd));

	ucmd.uscsi_cdb = (caddr_t)&cdb;
	ucmd.uscsi_cdblen = CDB_GROUP0;
	ucmd.uscsi_bufaddr = NULL;
	ucmd.uscsi_buflen = 0;
	ucmd.uscsi_rqbuf = (caddr_t)&sense;
	ucmd.uscsi_rqlen = sizeof (struct  scsi_extended_sense);
	ucmd.uscsi_timeout = 60;
	status = (issue_uscsi_cmd(fd, &ucmd, 0));

	(void) close(fd);
	return (status);
}

/*
 * Print out fabric dev dtype
 */
void
print_fabric_dtype_prop(uchar_t *hba_port_wwn, uchar_t *port_wwn,
	uchar_t dtype_prop)
{
	if ((dtype_prop & DTYPE_MASK) < 0x10) {
		(void) fprintf(stdout, " 0x%-2x (%s)\n",
		    (dtype_prop & DTYPE_MASK),
		    dtype[(dtype_prop & DTYPE_MASK)]);
	} else if ((dtype_prop & DTYPE_MASK) < 0x1f) {
		(void) fprintf(stdout,
		    MSGSTR(2096, " 0x%-2x (Reserved)\n"),
		    (dtype_prop & DTYPE_MASK));
	} else {
		/* Check to see if this is the HBA */
		if (wwnConversion(hba_port_wwn) != wwnConversion(port_wwn)) {
			(void) fprintf(stdout, MSGSTR(2097,
			    " 0x%-2x (Unknown Type)\n"),
			    (dtype_prop & DTYPE_MASK));
		} else {
			/* MATCH */
			(void) fprintf(stdout, MSGSTR(2241,
			    " 0x%-2x (Unknown Type,Host Bus Adapter)\n"),
			    (dtype_prop & DTYPE_MASK));
		}
	}
}


void
print_inq_data(char *arg_path, char *path, L_inquiry inq, uchar_t *serial,
    size_t serial_len)
{
	char	**p;
	uchar_t	*v_parm;
	int	scsi_3, length;
	char	byte_number[MAXNAMELEN];
	static	char *scsi_inquiry_labels_2[21];
	static	char *scsi_inquiry_labels_3[22];
#define	MAX_ANSI_VERSION	6
	static	char	*ansi_version[MAX_ANSI_VERSION];
	/*
	 * Intialize scsi_inquiry_labels_2 with i18n strings
	 */
	scsi_inquiry_labels_2[0] = MSGSTR(138, "Vendor:                     ");
	scsi_inquiry_labels_2[1] = MSGSTR(149, "Product:                    ");
	scsi_inquiry_labels_2[2] = MSGSTR(139, "Revision:                   ");
	scsi_inquiry_labels_2[3] = MSGSTR(143, "Firmware Revision           ");
	scsi_inquiry_labels_2[4] = MSGSTR(144, "Serial Number               ");
	scsi_inquiry_labels_2[5] = MSGSTR(140, "Device type:                ");
	scsi_inquiry_labels_2[6] = MSGSTR(145, "Removable media:            ");
	scsi_inquiry_labels_2[7] = MSGSTR(146, "ISO version:                ");
	scsi_inquiry_labels_2[8] = MSGSTR(147, "ECMA version:               ");
	scsi_inquiry_labels_2[9] = MSGSTR(148, "ANSI version:               ");
	scsi_inquiry_labels_2[10] =
	    MSGSTR(2168, "Async event notification:   ");
	scsi_inquiry_labels_2[11] =
	    MSGSTR(2169, "Terminate i/o process msg:  ");
	scsi_inquiry_labels_2[12] = MSGSTR(150, "Response data format:       ");
	scsi_inquiry_labels_2[13] = MSGSTR(151, "Additional length:          ");
	scsi_inquiry_labels_2[14] = MSGSTR(152, "Relative addressing:        ");
	scsi_inquiry_labels_2[15] =
	    MSGSTR(2170, "32 bit transfers:           ");
	scsi_inquiry_labels_2[16] =
	    MSGSTR(2171, "16 bit transfers:           ");
	scsi_inquiry_labels_2[17] =
	    MSGSTR(2172, "Synchronous transfers:      ");
	scsi_inquiry_labels_2[18] = MSGSTR(153, "Linked commands:            ");
	scsi_inquiry_labels_2[19] = MSGSTR(154, "Command queueing:           ");
	scsi_inquiry_labels_2[20] =
	    MSGSTR(2173, "Soft reset option:          ");

	/*
	 * Intialize scsi_inquiry_labels_3 with i18n strings
	 */
	scsi_inquiry_labels_3[0] = MSGSTR(138, "Vendor:                     ");
	scsi_inquiry_labels_3[1] = MSGSTR(149, "Product:                    ");
	scsi_inquiry_labels_3[2] = MSGSTR(139, "Revision:                   ");
	scsi_inquiry_labels_3[3] = MSGSTR(143, "Firmware Revision           ");
	scsi_inquiry_labels_3[4] = MSGSTR(144, "Serial Number               ");
	scsi_inquiry_labels_3[5] = MSGSTR(140, "Device type:                ");
	scsi_inquiry_labels_3[6] = MSGSTR(145, "Removable media:            ");
	scsi_inquiry_labels_3[7] = MSGSTR(2174, "Medium Changer Element:     ");
	scsi_inquiry_labels_3[8] = MSGSTR(146, "ISO version:                ");
	scsi_inquiry_labels_3[9] = MSGSTR(147, "ECMA version:               ");
	scsi_inquiry_labels_3[10] = MSGSTR(148, "ANSI version:               ");
	scsi_inquiry_labels_3[11] =
	    MSGSTR(2175, "Async event reporting:      ");
	scsi_inquiry_labels_3[12] =
	    MSGSTR(2176, "Terminate task:             ");
	scsi_inquiry_labels_3[13] =
	    MSGSTR(2177, "Normal ACA Supported:       ");
	scsi_inquiry_labels_3[14] = MSGSTR(150, "Response data format:       ");
	scsi_inquiry_labels_3[15] = MSGSTR(151, "Additional length:          ");
	scsi_inquiry_labels_3[16] =
	    MSGSTR(2178, "Cmd received on port:       ");
	scsi_inquiry_labels_3[17] =
	    MSGSTR(2179, "SIP Bits:                   ");
	scsi_inquiry_labels_3[18] = MSGSTR(152, "Relative addressing:        ");
	scsi_inquiry_labels_3[19] = MSGSTR(153, "Linked commands:            ");
	scsi_inquiry_labels_3[20] =
	    MSGSTR(2180, "Transfer Disable:           ");
	scsi_inquiry_labels_3[21] = MSGSTR(154, "Command queueing:           ");

	/*
	 * Intialize scsi_inquiry_labels_3 with i18n strings
	 */
	ansi_version[0] = MSGSTR(2181,
	    " (Device might or might not comply to an ANSI version)");
	ansi_version[1] = MSGSTR(2182,
	    " (This code is reserved for historical uses)");
	ansi_version[2] = MSGSTR(2183,
	    " (Device complies to ANSI X3.131-1994 (SCSI-2))");
	ansi_version[3] = MSGSTR(2184,
	    " (Device complies to ANSI INCITS 301-1997 (SPC))");
	ansi_version[4] = MSGSTR(2226,
	    " (Device complies to ANSI INCITS 351-2001 (SPC-2))");
	ansi_version[5] = MSGSTR(2227,
	    " (Device complies to ANSI INCITS 408-2005 (SPC-3))");

	/* print inquiry information */

	(void) fprintf(stdout, MSGSTR(2185, "\nINQUIRY:\n"));
		/*
		 * arg_path is the path sent to luxadm by the user.  if arg_path
		 * is a /devices path, then we do not need to print out physical
		 * path info
		 */
	if (strcmp(arg_path, path) != 0 &&
	    strstr(arg_path, "/devices/") == NULL) {
		(void) fprintf(stdout, "  ");
		(void) fprintf(stdout,
		    MSGSTR(5, "Physical Path:"));
		(void) fprintf(stdout, "\n  %s\n", path);
	}
	if (inq.inq_ansi < 3) {
		p = scsi_inquiry_labels_2;
		scsi_3 = 0;
	} else {
		p = scsi_inquiry_labels_3;
		scsi_3 = 1;
	}
	if (inq.inq_len < 11) {
		p += 1;
	} else {
		/* */
		(void) fprintf(stdout, "%s", *p++);
		print_chars(inq.inq_vid, sizeof (inq.inq_vid), 0);
		(void) fprintf(stdout, "\n");
	}
	if (inq.inq_len < 27) {
		p += 1;
	} else {
		(void) fprintf(stdout, "%s", *p++);
		print_chars(inq.inq_pid, sizeof (inq.inq_pid), 0);
		(void) fprintf(stdout, "\n");
	}
	if (inq.inq_len < 31) {
		p += 1;
	} else {
		(void) fprintf(stdout, "%s", *p++);
		print_chars(inq.inq_revision, sizeof (inq.inq_revision), 0);
		(void) fprintf(stdout, "\n");
	}
	if (inq.inq_len < 39) {
		p += 2;
	} else {
		/*
		 * If Pluto then print
		 * firmware rev & serial #.
		 */
		if (strstr((char *)inq.inq_pid, "SSA") != 0) {
			(void) fprintf(stdout, "%s", *p++);
			print_chars(inq.inq_firmware_rev,
			    sizeof (inq.inq_firmware_rev), 0);
			(void) fprintf(stdout, "\n");
			(void) fprintf(stdout, "%s", *p++);
			print_chars(serial, serial_len, 0);
			(void) fprintf(stdout, "\n");
		} else if ((inq.inq_dtype & DTYPE_MASK) != DTYPE_ESI) {
			p++;
			(void) fprintf(stdout, "%s", *p++);
			print_chars(serial, serial_len, 0);
			(void) fprintf(stdout, "\n");
		} else {
			/* if we miss both the above if's */
			p += 2;
		}
	}

	(void) fprintf(stdout, "%s0x%x (", *p++, (inq.inq_dtype & DTYPE_MASK));
	if ((inq.inq_dtype & DTYPE_MASK) < 0x10) {
		(void) fprintf(stdout, "%s", dtype[inq.inq_dtype & DTYPE_MASK]);
	} else if ((inq.inq_dtype & DTYPE_MASK) < 0x1f) {
		(void) fprintf(stdout, MSGSTR(71, "Reserved"));
	} else {
		(void) fprintf(stdout, MSGSTR(2186, "Unknown device"));
	}
	(void) fprintf(stdout, ")\n");

	(void) fprintf(stdout, "%s", *p++);
	if (inq.inq_rmb != NULL) {
		(void) fprintf(stdout, MSGSTR(40, "yes"));
	} else {
		(void) fprintf(stdout, MSGSTR(45, "no"));
	}
	(void) fprintf(stdout, "\n");

	if (scsi_3) {
		(void) fprintf(stdout, "%s", *p++);
		if (inq.inq_mchngr != NULL) {
			(void) fprintf(stdout, MSGSTR(40, "yes"));
		} else {
			(void) fprintf(stdout, MSGSTR(45, "no"));
		}
		(void) fprintf(stdout, "\n");
	}
	(void) fprintf(stdout, "%s%d\n", *p++, inq.inq_iso);
	(void) fprintf(stdout, "%s%d\n", *p++, inq.inq_ecma);

	(void) fprintf(stdout, "%s%d", *p++, inq.inq_ansi);
	if (inq.inq_ansi < MAX_ANSI_VERSION) {
		(void) fprintf(stdout, "%s", ansi_version[inq.inq_ansi]);
	} else
		(void) fprintf(stdout, " (%s)", MSGSTR(71, "Reserved"));

	(void) fprintf(stdout, "\n");

	if (inq.inq_aenc) {
		(void) fprintf(stdout, "%s", *p++);
		(void) fprintf(stdout, MSGSTR(40, "yes"));
		(void) fprintf(stdout, "\n");
	} else {
		p++;
	}
	if (scsi_3) {
		(void) fprintf(stdout, "%s", *p++);
		if (inq.inq_normaca != NULL) {
			(void) fprintf(stdout, MSGSTR(40, "yes"));
		} else {
			(void) fprintf(stdout, MSGSTR(45, "no"));
		}
		(void) fprintf(stdout, "\n");
	}
	if (inq.inq_trmiop) {
		(void) fprintf(stdout, "%s", *p++);
		(void) fprintf(stdout, MSGSTR(40, "yes"));
		(void) fprintf(stdout, "\n");
	} else {
		p++;
	}
	(void) fprintf(stdout, "%s%d\n", *p++, inq.inq_rdf);
	(void) fprintf(stdout, "%s0x%x\n", *p++, inq.inq_len);
	if (scsi_3) {
		if (inq.inq_dual_p) {
			if (inq.inq_port != NULL) {
				(void) fprintf(stdout, MSGSTR(2187,
				    "%sa\n"), *p++);
			} else {
				(void) fprintf(stdout, MSGSTR(2188,
				    "%sb\n"), *p++);
			}
		} else {
			p++;
		}
	}
	if (scsi_3) {
		if (inq.inq_SIP_1 || inq.ui.inq_3.inq_SIP_2 ||
		    inq.ui.inq_3.inq_SIP_3) {
			(void) fprintf(stdout, "%s%d, %d, %d\n", *p,
			    inq.inq_SIP_1, inq.ui.inq_3.inq_SIP_2,
			    inq.ui.inq_3.inq_SIP_3);
		}
		p++;

	}

	if (inq.ui.inq_2.inq_2_reladdr) {
		(void) fprintf(stdout, "%s", *p);
		(void) fprintf(stdout, MSGSTR(40, "yes"));
		(void) fprintf(stdout, "\n");
	}
	p++;

	if (!scsi_3) {
		if (inq.ui.inq_2.inq_wbus32) {
			(void) fprintf(stdout, "%s", *p);
			(void) fprintf(stdout, MSGSTR(40, "yes"));
			(void) fprintf(stdout, "\n");
		}
		p++;

		if (inq.ui.inq_2.inq_wbus16) {
			(void) fprintf(stdout, "%s", *p);
			(void) fprintf(stdout, MSGSTR(40, "yes"));
			(void) fprintf(stdout, "\n");
		}
		p++;

		if (inq.ui.inq_2.inq_sync) {
			(void) fprintf(stdout, "%s", *p);
			(void) fprintf(stdout, MSGSTR(40, "yes"));
			(void) fprintf(stdout, "\n");
		}
		p++;

	}
	if (inq.ui.inq_2.inq_linked) {
		(void) fprintf(stdout, "%s", *p);
		(void) fprintf(stdout, MSGSTR(40, "yes"));
		(void) fprintf(stdout, "\n");
	}
	p++;

	if (scsi_3) {
		(void) fprintf(stdout, "%s", *p++);
		if (inq.ui.inq_3.inq_trandis != NULL) {
			(void) fprintf(stdout, MSGSTR(40, "yes"));
		} else {
			(void) fprintf(stdout, MSGSTR(45, "no"));
		}
		(void) fprintf(stdout, "\n");
	}

	if (inq.ui.inq_2.inq_cmdque) {
		(void) fprintf(stdout, "%s", *p);
		(void) fprintf(stdout, MSGSTR(40, "yes"));
		(void) fprintf(stdout, "\n");
	}
	p++;

	if (!scsi_3) {
		if (inq.ui.inq_2.inq_sftre) {
			(void) fprintf(stdout, "%s", *p);
			(void) fprintf(stdout, MSGSTR(40, "yes"));
			(void) fprintf(stdout, "\n");
		}
		p++;

	}

	/*
	 * Now print the vendor-specific data.
	 */
	v_parm = inq.inq_ven_specific_1;
	if (inq.inq_len >= 32) {
		length = inq.inq_len - 31;
		if (strstr((char *)inq.inq_pid, "SSA") != 0) {
			(void) fprintf(stdout, MSGSTR(2189,
			    "Number of Ports, Targets:   %d,%d\n"),
			    inq.inq_ssa_ports, inq.inq_ssa_tgts);
			v_parm += 20;
			length -= 20;
		} else if ((strstr((char *)inq.inq_pid, "SUN") != 0) ||
		    (strncmp((char *)inq.inq_vid, "SUN     ",
		    sizeof (inq.inq_vid)) == 0)) {
			v_parm += 16;
			length -= 16;
		}
		/*
		 * Do hex Dump of rest of the data.
		 */
		if (length > 0) {
			(void) fprintf(stdout,
			    MSGSTR(2190,
			"              VENDOR-SPECIFIC PARAMETERS\n"));
			(void) fprintf(stdout,
			    MSGSTR(2191,
			    "Byte#                  Hex Value            "
			    "                 ASCII\n"));
			(void) sprintf(byte_number,
			    "%d    ", inq.inq_len - length + 5);
			dump_hex_data(byte_number, v_parm,
			    MIN(length, inq.inq_res3 - v_parm), HEX_ASCII);
		}
		/*
		 * Skip reserved bytes 56-95.
		 */
		length -= (inq.inq_box_name - v_parm);
		if (length > 0) {
			(void) sprintf(byte_number, "%d    ",
			    inq.inq_len - length + 5);
			dump_hex_data(byte_number, inq.inq_box_name,
			    MIN(length, sizeof (inq.inq_box_name) +
			    sizeof (inq.inq_avu)), HEX_ASCII);
		}
	}
	if (getenv("_LUX_D_DEBUG") != NULL) {
		dump_hex_data("\nComplete Inquiry: ",
		    (uchar_t *)&inq,
		    MIN(inq.inq_len + 5, sizeof (inq)), HEX_ASCII);
	}
}

/*
 * Internal routine to clean up ../'s in paths.
 * returns 0 if no "../" are left.
 *
 * Wouldn't it be nice if there was a standard system library
 * routine to do this...?
 */
static int
cleanup_dotdot_path(char *path)
{
	char holder[MAXPATHLEN];
	char *dotdot;
	char *previous_slash;

	/* Find the first "/../" in the string */
	dotdot = strstr(path, "/../");
	if (dotdot == NULL) {
		return (0);
	}


	/*
	 * If the [0] character is '/' and "../" immediatly
	 * follows it, then we can strip the ../
	 *
	 *	/../../foo/bar == /foo/bar
	 *
	 */
	if (dotdot == path) {
		strcpy(holder, &path[3]); /* strip "/.." */
		strcpy(path, holder);
		return (1);
	}

	/*
	 * Now look for the LAST "/" before the "/../"
	 * as this is the parent dir we can get rid of.
	 * We do this by temporarily truncating the string
	 * at the '/' just before "../" using the dotdot pointer.
	 */
	*dotdot = '\0';
	previous_slash = strrchr(path, '/');
	if (previous_slash == NULL) {
		/*
		 * hmm, somethings wrong.  path looks something
		 * like "foo/../bar/" so we can't really deal with it.
		 */
		return (0);
	}
	/*
	 * Now truncate the path just after the previous '/'
	 * and slam everything after the "../" back on
	 */
	*(previous_slash+1) = '\0';
	(void) strcat(path, dotdot+4);
	return (1); /* We may have more "../"s */
}

/*
 * Follow symbolic links from the logical device name to
 * the /devfs physical device name.  To be complete, we
 * handle the case of multiple links.  This function
 * either returns NULL (no links, or some other error),
 * or the physical device name, alloc'ed on the heap.
 *
 * NOTE: If the path is relative, it will be forced into
 * an absolute path by pre-pending the pwd to it.
 */
char *
get_slash_devices_from_osDevName(char *osDevName, int flag)
{
	struct stat	stbuf;
	char		source[MAXPATHLEN];
	char		scratch[MAXPATHLEN];
	char		pwd[MAXPATHLEN];
	char		*tmp, *phys_path;
	int		cnt;
	boolean_t	is_lstat_failed = B_TRUE;

	/* return NULL if path is NULL */
	if (osDevName == NULL) {
		return (NULL);
	}

	strcpy(source, osDevName);
	for (;;) {

		/*
		 * First make sure the path is absolute.  If not, make it.
		 * If it's already an absolute path, we have no need
		 * to determine the cwd, so the program should still
		 * function within security-by-obscurity directories.
		 */
		if (source[0] != '/') {
			tmp = getcwd(pwd, MAXPATHLEN);
			if (tmp == NULL) {
				return (NULL);
			}
			/*
			 * Handle special case of "./foo/bar"
			 */
			if (source[0] == '.' && source[1] == '/') {
				strcpy(scratch, source+2);
			} else { /* no "./" so just take everything */
				strcpy(scratch, source);
			}
			strcpy(source, pwd);
			(void) strcat(source, "/");
			(void) strcat(source, scratch);
		}

		/*
		 * Clean up any "../"s that are in the path
		 */
		while (cleanup_dotdot_path(source))
			;

		/*
		 * source is now an absolute path to the link we're
		 * concerned with
		 */
		if (flag == NOT_IGNORE_DANGLING_LINK) {
			/*
			 * In order not to ingore dangling links, check
			 * the lstat. If lstat succeeds, return the path
			 * from readlink.
			 * Note: osDevName input with /devices path from
			 * a dangling /dev link doesn't pass lstat so
			 * NULL is returned.
			 */
			if (stat(source, &stbuf) == -1) {
				if (!is_lstat_failed &&
				    strstr(source, "/devices")) {
					/*
					 * lstat succeeded previously and source
					 * contains "/devices" then it is
					 * dangling node.
					 */
					phys_path = (char *)calloc(1,
					    strlen(source) + 1);
					if (phys_path != NULL) {
						(void) strncpy(phys_path,
						    source, strlen(source) + 1);
					}
					return (phys_path);
				} else if (is_lstat_failed) {
					/* check lstat result. */
					if (lstat(source, &stbuf) == -1) {
						return (NULL);
					} else {
						/* and continue */
						is_lstat_failed = B_FALSE;
					}
				} else {
					/*
					 * With algorithm that resolves a link
					 * and then issues readlink(), should
					 * not be reached here.
					 */
					return (NULL);
				}
			} else {
				if (lstat(source, &stbuf) == -1) {
					/*
					 * when stat succeeds it is not
					 * a dangling node so it is not
					 * a special case.
					 */
					return (NULL);
				}
			}
		} else if (flag == STANDARD_DEVNAME_HANDLING) {
			/*
			 * See if there's a real file out there.  If not,
			 * we have a dangling link and we ignore it.
			 */
			if (stat(source, &stbuf) == -1) {
				return (NULL);
			}
			if (lstat(source, &stbuf) == -1) {
				return (NULL);
			}
		} else {
			/* invalid flag */
			return (NULL);
		}

		/*
		 * If the file is not a link, we're done one
		 * way or the other.  If there were links,
		 * return the full pathname of the resulting
		 * file.
		 *
		 * Note:  All of our temp's are on the stack,
		 * so we have to copy the final result to the heap.
		 */
		if (!S_ISLNK(stbuf.st_mode)) {
			phys_path = (char *)calloc(1, strlen(source) + 1);
			if (phys_path != NULL) {
				(void) strncpy(phys_path, source,
				    strlen(source) + 1);
			}
			return (phys_path);
		}
		cnt = readlink(source, scratch, sizeof (scratch));
		if (cnt < 0) {
			return (NULL);
		}
		/*
		 * scratch is on the heap, and for some reason readlink
		 * doesn't always terminate things properly so we have
		 * to make certain we're properly terminated
		 */
		scratch[cnt] = '\0';

		/*
		 * Now check to see if the link is relative.  If so,
		 * then we have to append it to the directory
		 * which the source was in. (This is non trivial)
		 */
		if (scratch[0] != '/') {
			tmp = strrchr(source, '/');
			if (tmp == NULL) { /* Whoa!  Something's hosed! */
				O_DPRINTF("Internal error... corrupt path.\n");
				return (NULL);
			}
			/* Now strip off just the directory path */
			*(tmp+1) = '\0'; /* Keeping the last '/' */
			/* and append the new link */
			(void) strcat(source, scratch);
			/*
			 * Note:  At this point, source should have "../"s
			 * but we'll clean it up in the next pass through
			 * the loop.
			 */
		} else {
			/* It's an absolute link so no worries */
			strcpy(source, scratch);
		}
	}
	/* Never reach here */
}

/*
 * Input - Space for client_path, phci_path and paddr fields of ioc structure
 * need to be allocated by the caller of this routine.
 */
int
get_scsi_vhci_pathinfo(char *dev_path, sv_iocdata_t *ioc, int *path_count)
{
	char	*physical_path, *physical_path_s;
	int	retval;
	int	fd;
	int	initial_path_count;
	int	current_path_count;
	int 	i;
	char	*delimiter;
	int	malloc_error = 0;
	int 	prop_buf_size;
	int	pathlist_retry_count = 0;

	if (strncmp(dev_path, SCSI_VHCI, strlen(SCSI_VHCI)) != NULL) {
		if ((physical_path = get_slash_devices_from_osDevName(
		    dev_path, STANDARD_DEVNAME_HANDLING)) == NULL) {
			return (L_INVALID_PATH);
		}
		if (strncmp(physical_path, SCSI_VHCI,
		    strlen(SCSI_VHCI)) != NULL) {
			free(physical_path);
			return (L_INVALID_PATH);
		}
	} else {
		if ((physical_path = calloc(1, MAXPATHLEN)) == NULL) {
			return (L_MALLOC_FAILED);
		}
		(void) strcpy(physical_path, dev_path);
	}
	physical_path_s = physical_path;

	/* move beyond "/devices" prefix */
	physical_path += DEV_PREFIX_STRLEN-1;
	/* remove  :c,raw suffix */
	delimiter = strrchr(physical_path, ':');
	/* if we didn't find the ':' fine, else truncate */
	if (delimiter != NULL) {
		*delimiter = NULL;
	}

	/*
	 * We'll call ioctl SCSI_VHCI_GET_CLIENT_MULTIPATH_INFO
	 * at least twice.  The first time will get the path count
	 * and the size of the ioctl propoerty buffer.  The second
	 * time will get the path_info for each path.
	 *
	 * It's possible that additional paths are added while this
	 * code is running.  If the path count increases between the
	 * 2 ioctl's above, then we'll retry (and assume all is well).
	 */
	(void) strcpy(ioc->client, physical_path);
	ioc->buf_elem = 1;
	ioc->ret_elem = (uint_t *)&(initial_path_count);
	ioc->ret_buf = NULL;

	/* free physical path */
	free(physical_path_s);

	/* 0 buf_size asks driver to return actual size needed */
	/* open the ioctl file descriptor */
	if ((fd = open("/devices/scsi_vhci:devctl", O_RDWR)) < 0) {
		return (L_OPEN_PATH_FAIL);
	}

	retval = ioctl(fd, SCSI_VHCI_GET_CLIENT_MULTIPATH_INFO, ioc);
	if (retval != 0) {
		close(fd);
		return (L_SCSI_VHCI_ERROR);
	}
	prop_buf_size = SV_PROP_MAX_BUF_SIZE;


	while (pathlist_retry_count <= RETRY_PATHLIST) {
		ioc->buf_elem = initial_path_count;
		/* Make driver put actual # paths in variable */
		ioc->ret_elem = (uint_t *)&(current_path_count);

		/*
		 * Allocate space for array of path_info structures.
		 * Allocate enough space for # paths from get_pathcount
		 */
		ioc->ret_buf = (sv_path_info_t *)
		    calloc(initial_path_count, sizeof (sv_path_info_t));
		if (ioc->ret_buf == NULL) {
			close(fd);
			return (L_MALLOC_FAILED);
		}

		/*
		 * Allocate space for path properties returned by driver
		 */
		malloc_error = 0;
		for (i = 0; i < initial_path_count; i++) {
			ioc->ret_buf[i].ret_prop.buf_size = prop_buf_size;
			if ((ioc->ret_buf[i].ret_prop.buf =
			    (caddr_t)malloc(prop_buf_size)) == NULL) {
				malloc_error = 1;
				break;
			}
			if ((ioc->ret_buf[i].ret_prop.ret_buf_size =
			    (uint_t *)malloc(sizeof (uint_t))) == NULL) {
				malloc_error = 1;
				break;
			}
		}
		if (malloc_error == 1) {
			for (i = 0; i < initial_path_count; i++) {
				free(ioc->ret_buf[i].ret_prop.buf);
				free(ioc->ret_buf[i].ret_prop.ret_buf_size);
			}
			free(ioc->ret_buf);
			close(fd);
			return (L_MALLOC_FAILED);
		}

		retval = ioctl(fd, SCSI_VHCI_GET_CLIENT_MULTIPATH_INFO, ioc);
		if (retval != 0) {
			for (i = 0; i < initial_path_count; i++) {
				free(ioc->ret_buf[i].ret_prop.buf);
				free(ioc->ret_buf[i].ret_prop.ret_buf_size);
			}
			free(ioc->ret_buf);
			close(fd);
			return (L_SCSI_VHCI_ERROR);
		}
		if (initial_path_count < current_path_count) {
			/* then a new path was added */
			pathlist_retry_count++;
			initial_path_count = current_path_count;
		} else {
			break;
		}
	}
	/* we are done with ioctl's, lose the fd */
	close(fd);

	/*
	 * Compare the length num elements from the ioctl response
	 *   and the caller's request - use smaller value.
	 *
	 * pathlist_p->path_count now has count returned from ioctl.
	 * ioc.buf_elem has the value the caller provided.
	 */
	if (initial_path_count < current_path_count) {
		/* More paths exist than we allocated space for */
		*path_count = initial_path_count;
	} else {
		*path_count = current_path_count;
	}

	return (0);
}

int
get_mode_page(char *path, uchar_t **pg_buf)
{
	struct mode_header_g1	*mode_header_ptr;
	int		status, size, fd;

	/* open controller */
	if ((fd = open(path, O_NDELAY | O_RDWR)) == -1)
		return (-1); /* L_OPEN_PATH_FAIL */

	/*
	 * Read the first part of the page to get the page size
	 */
	size = 20;
	if ((*pg_buf = (uchar_t *)calloc(1, size)) == NULL) {
		(void) close(fd);
		return (L_MALLOC_FAILED);
	}
	/* read page */
	if (status = scsi_mode_sense_cmd(fd, *pg_buf, size,
	    0, MODEPAGE_ALLPAGES)) {
		(void) close(fd);
		(void) free(*pg_buf);
		return (status);
	}
	/* Now get the size for all pages */
	mode_header_ptr = (struct mode_header_g1 *)(void *)*pg_buf;
	size = ntohs(mode_header_ptr->length) +
	    sizeof (mode_header_ptr->length);
	(void) free(*pg_buf);
	if ((*pg_buf = (uchar_t *)calloc(1, size)) == NULL) {
		(void) close(fd);
		return (L_MALLOC_FAILED);
	}
	/* read all pages */
	if (status = scsi_mode_sense_cmd(fd, *pg_buf, size,
	    0, MODEPAGE_ALLPAGES)) {
		(void) close(fd);
		(void) free(*pg_buf);
		return (status);
	}
	(void) close(fd);
	return (0);
}

/*
 * Dump a structure in hexadecimal.
 */
void
dump_hex_data(char *hdr, uchar_t *src, int nbytes, int format)
{
	int i;
	int n;
	char	*p;
	char	s[256];

	assert(format == HEX_ONLY || format == HEX_ASCII);

	(void) strcpy(s, hdr);
	for (p = s; *p; p++) {
		*p = ' ';
	}

	p = hdr;
	while (nbytes > 0) {
		(void) fprintf(stdout, "%s", p);
		p = s;
		n = MIN(nbytes, BYTES_PER_LINE);
		for (i = 0; i < n; i++) {
			(void) fprintf(stdout, "%02x ", src[i] & 0xff);
		}
		if (format == HEX_ASCII) {
			for (i = BYTES_PER_LINE-n; i > 0; i--) {
				(void) fprintf(stdout, "   ");
			}
			(void) fprintf(stdout, "    ");
			for (i = 0; i < n; i++) {
				(void) fprintf(stdout, "%c",
				    isprint(src[i]) ? src[i] : '.');
			}
		}
		(void) fprintf(stdout, "\n");
		nbytes -= n;
		src += n;
	}
}