VSCSIDevice.cpp revision 26947320577c481b4afefdb0afbb855181e5b2e8
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * Virtual SCSI driver: Device handling
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * Copyright (C) 2006-2010 Sun Microsystems, Inc.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * available from http://www.virtualbox.org. This file is free software;
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * you can redistribute it and/or modify it under the terms of the GNU
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * General Public License (GPL) as published by the Free Software
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * additional information or have any questions.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * Checks if a specific LUN exists fir the SCSI device
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * @returns true if the LUN is present
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * false otherwise
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * @param pVScsiDevice The SCSI device instance.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * @param iLun The LUN to check for.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsyncDECLINLINE(bool) vscsiDeviceLunIsPresent(PVSCSIDEVICEINT pVScsiDevice, uint32_t iLun)
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync * Process a request common for all device types.
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync * @returns Flag whether we could handle the request.
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync * @param pVScsiDevice The virtual SCSI device instance.
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync * @param pVScsiReq The SCSi request.
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync * @param prcReq The final return value if the request was handled.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsyncstatic bool vscsiDeviceReqProcess(PVSCSIDEVICEINT pVScsiDevice, PVSCSIREQINT pVScsiReq,
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync if (!vscsiDeviceLunIsPresent(pVScsiDevice, pVScsiReq->iLun))
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync memset(&ScsiInquiryReply, 0, sizeof(ScsiInquiryReply));
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync ScsiInquiryReply.u5PeripheralDeviceType = SCSI_INQUIRY_DATA_PERIPHERAL_DEVICE_TYPE_UNKNOWN;
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync ScsiInquiryReply.u3PeripheralQualifier = SCSI_INQUIRY_DATA_PERIPHERAL_QUALIFIER_NOT_CONNECTED_NOT_SUPPORTED;
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync cbData = vscsiCopyToIoMemCtx(&pVScsiReq->IoMemCtx, (uint8_t *)&ScsiInquiryReply, sizeof(SCSIINQUIRYDATA));
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync fProcessed = false; /* Let the LUN process the request because it will provide LUN specific data */
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * If allocation length is less than 16 bytes SPC compliant devices have
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync * to return an error.
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync *prcReq = vscsiReqSenseErrorSet(pVScsiReq, SCSI_SENSE_ILLEGAL_REQUEST, SCSI_ASC_INV_FIELD_IN_CMD_PACKET);
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync vscsiH2BEU32(&aReply[0], 8); /* List length starts at position 0. */
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync cbData = vscsiCopyToIoMemCtx(&pVScsiReq->IoMemCtx, aReply, sizeof(aReply));
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync *prcReq = vscsiReqSenseErrorSet(pVScsiReq, SCSI_SENSE_ILLEGAL_REQUEST, SCSI_ASC_INV_FIELD_IN_CMD_PACKET);
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync * Completesa SCSI request and calls the completion handler.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * @returns nothing.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * @param pVScsiDevice The virtual SCSI device.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * @param pVScsiReq The request which completed.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * @param rcReq The status code
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync * One of the SCSI_STATUS_* #defines.
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsyncvoid vscsiDeviceReqComplete(PVSCSIDEVICEINT pVScsiDevice, PVSCSIREQINT pVScsiReq,
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync pVScsiDevice->pfnVScsiReqCompleted(pVScsiDevice, pVScsiDevice->pvVScsiDeviceUser,
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync RTMemCacheFree(pVScsiDevice->hCacheReq, pVScsiReq);
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsyncVBOXDDU_DECL(int) VSCSIDeviceCreate(PVSCSIDEVICE phVScsiDevice,
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync AssertPtrReturn(phVScsiDevice, VERR_INVALID_POINTER);
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync AssertPtrReturn(pfnVScsiReqCompleted, VERR_INVALID_POINTER);
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync pVScsiDevice = (PVSCSIDEVICEINT)RTMemAllocZ(sizeof(VSCSIDEVICEINT));
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync pVScsiDevice->pfnVScsiReqCompleted = pfnVScsiReqCompleted;
e4c4f1dc57eeabb8863d43b128783766afee2000vboxsync pVScsiDevice->pvVScsiDeviceUser = pvVScsiDeviceUser;
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync rc = RTMemCacheCreate(&pVScsiDevice->hCacheReq, sizeof(VSCSIREQINT), 0, UINT32_MAX,
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync LogFlow(("%s: hVScsiDevice=%#p -> VINF_SUCCESS\n", __FUNCTION__, pVScsiDevice));
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsyncVBOXDDU_DECL(int) VSCSIDeviceDestroy(VSCSIDEVICE hVScsiDevice)
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync AssertPtrReturn(hVScsiDevice, VERR_INVALID_HANDLE);
0b74a2f80aba476dc8be8bc1c63891fc53945986vboxsync PVSCSIDEVICEINT pVScsiDevice = (PVSCSIDEVICEINT)hVScsiDevice;
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsyncVBOXDDU_DECL(int) VSCSIDeviceLunAttach(VSCSIDEVICE hVScsiDevice, VSCSILUN hVScsiLun, uint32_t iLun)
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync PVSCSIDEVICEINT pVScsiDevice = (PVSCSIDEVICEINT)hVScsiDevice;
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync /* Parameter checks */
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync AssertPtrReturn(pVScsiDevice, VERR_INVALID_HANDLE);
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync AssertReturn(iLun < VSCSI_DEVICE_LUN_MAX, VERR_VSCSI_LUN_INVALID);
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync AssertReturn(!pVScsiLun->pVScsiDevice, VERR_VSCSI_LUN_ATTACHED_TO_DEVICE);
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync PPVSCSILUNINT papLunOld = pVScsiDevice->papVScsiLun;
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync pVScsiDevice->papVScsiLun = (PPVSCSILUNINT)RTMemAllocZ((iLun + 1) * sizeof(PVSCSILUNINT));
1e29d016a09a61485fda74f7fca39e171ff5dda8vboxsync for (uint32_t i = 0; i < pVScsiDevice->cLunsMax; i++)
return rc;
return VINF_SUCCESS;
return VINF_SUCCESS;
int rcReq;
if (!fProcessed)
rcReq);
return rc;
if (!pVScsiReq)
return VERR_NO_MEMORY;
return VINF_SUCCESS;