/***************************************************************************
 * Copyright 2008 VMware, Inc.  All rights reserved.
 ***************************************************************************/

/*
 * @VMKAPIMOD_LICENSE@
 */


/*
 * vmkapi_scsi_device.h --
 *
 *	SCSI device related API.
 *  
 */
#ifndef _VMKAPI_SCSI_DEVICE_H_
#define _VMKAPI_SCSI_DEVICE_H_

#ifndef VMK_HEADER_INCLUDED_FROM_VMKAPI_H
#error This vmkapi file should never be included directly but only via vmkapi.h
#endif

struct vmk_ScsiDevice;

/*
 ***********************************************************************
 * vmk_ScsiDeviceGetIdFromPage83 --                               */ /**
 *
 * \ingroup SCSI
 *
 * \brief Get the device UID of given type from page 83 inquiry buffer
 *
 * Return device uid (max upto 'idLength' bytes) of the requested
 * device uid type/association in caller-provided buffer 'id'. If desc
 * value is non NULL return the identifier descriptor header.
 *
 * \note The returned descriptor is not NULL terminated (many ID types
 *       can contain NULL as valid data). The length of the returned
 *       descriptor is in the desc->idLen field.
 *
 * \note This function will not block.
 *
 * \note Spin locks can be held while calling into this function
 *
 * \param[in]  vmkDevice  SCSI device whose id is requested.
 * \param[in]  idType     SCSI identifier type
 * \param[in]  assoc      SCSI association type
 * \param[in]  idLength   Size of identifier buffer
 * \param[out] id         Identifier buffer
 * \param[out] desc       Buffer of type vmk_ScsiInquiryVPD83IdDesc for
 *                        returning identifier descriptor 
 *
 * \retval VMK_OK   Requested id was found and returned in'id' buffer.
 * \retval Other    An error occured.
 *
 ***********************************************************************
 */
VMK_ReturnStatus
vmk_ScsiDeviceGetIdFromPage83(
   struct vmk_ScsiDevice *vmkDevice,
   vmk_ScsiIdentifierType idType,
   vmk_ScsiAssociationType assoc,
   vmk_ByteCountSmall idLength,
   vmk_uint8 *id,
   vmk_ScsiInquiryVPD83IdDesc *desc);

#endif //_VMKAPI_SCSI_DEVICE_H_