/**
* @brief This routine is to free the memory for a completed internal request.
*
* @param[in] scif_controller handle to frame controller
* @param[in] fw_internal_io The internal IO to be freed.
*
* @return none
*/
void scif_sas_controller_free_internal_request(
SCIF_SAS_CONTROLLER_T * fw_controller,
void * fw_internal_request_buffer
)
{
SCIF_LOG_TRACE((
sci_base_object_get_logger(fw_controller),
SCIF_LOG_OBJECT_CONTROLLER | SCIF_LOG_OBJECT_IO_REQUEST,
"scif_controller_free_internal_request(0x%x, 0x%x) enter\n",
fw_controller, fw_internal_request_buffer
));
//return the memory to to pool.
if( !sci_pool_full(fw_controller->internal_request_memory_pool) )
{
sci_pool_put(
fw_controller->internal_request_memory_pool,
(POINTER_UINT) fw_internal_request_buffer
);
}
}
/**
* @brief This method constructs an internal smp request.
*
* @param[in] fw_controller The framework controller
* @param[in] fw_device The smp device that the internal io targets to.
* @param[in] internal_io_memory The memory space for the internal io.
* @param[in] io_tag The io tag for the internl io to be constructed.
* @param[in] smp_command A pointer to the smp request data structure according
* to SAS protocol.
*
* @return Indicate if the internal io was successfully constructed.
* @retval SCI_SUCCESS This value is returned if the internal io was
* successfully constructed.
* @retval SCI_FAILURE This value is returned if the internal io was failed to
* be constructed.
*/
SCI_STATUS scif_sas_internal_io_request_construct_smp(
SCIF_SAS_CONTROLLER_T * fw_controller,
SCIF_SAS_REMOTE_DEVICE_T * fw_device,
void * internal_io_memory,
U16 io_tag,
SMP_REQUEST_T * smp_command
)
{
SCIF_SAS_INTERNAL_IO_REQUEST_T * fw_internal_io =
(SCIF_SAS_INTERNAL_IO_REQUEST_T*)internal_io_memory;
SCIF_SAS_IO_REQUEST_T * fw_io =
(SCIF_SAS_IO_REQUEST_T*)internal_io_memory;
SCI_STATUS status;
//call common smp request construct routine.
status = scif_sas_io_request_construct_smp(
fw_controller,
fw_device,
internal_io_memory,
(char *)internal_io_memory + sizeof(SCIF_SAS_INTERNAL_IO_REQUEST_T),
SCI_CONTROLLER_INVALID_IO_TAG,
smp_command,
NULL //there is no associated user io object.
);
//Codes below are all internal io related.
if (status == SCI_SUCCESS)
{
//set the is_internal flag
fw_io->parent.is_internal = TRUE;
if (fw_internal_io->internal_io_timer == NULL)
{
//create the timer for this internal request.
fw_internal_io->internal_io_timer =
scif_cb_timer_create(
(SCI_CONTROLLER_HANDLE_T *)fw_controller,
scif_sas_internal_io_request_timeout_handler,
(void*)fw_io
);
}
else
{
ASSERT (0);
}
//insert into high priority queue
if ( !sci_pool_full(fw_controller->hprq.pool) )
{
sci_pool_put(
fw_controller->hprq.pool, (POINTER_UINT) internal_io_memory
);
}
else
{
SCIF_LOG_ERROR((
sci_base_object_get_logger(fw_controller),
SCIF_LOG_OBJECT_CONTROLLER | SCIF_LOG_OBJECT_REMOTE_DEVICE,
"scif_sas_internal_io_request_construct_smp, high priority queue full!\n"
));
scif_sas_internal_io_request_destruct(fw_controller, fw_internal_io);
//return failure status.
return SCI_FAILURE_INSUFFICIENT_RESOURCES;
}
}
return status;
}
