Driver Entry Points				sata_tran_port_activate(9E)

NAME
    sata_tran_port_activate - activate SATA port and establish link with
                              attached device.
                              
SYNOPSIS
    #include <sys/sata/impl/sata_hba.h>

    int sata_tran_port_activate(dev_info_t  *dev_info,
                                sata_device_t *sata_device);

INTERFACE LEVEL
    Consolidation Private

PARAMETERS
    dev_info 		Pointer to a dev_info_t structure, referring to
     			the HBA device instance.
    sata_device		Pointer to sata_device structure identifying the
    			target port.

DESCRIPTION
    This function performs SATA HBA-specific operation of activating the port
    and establishing communication with an attached device (if any). If
    necessary the power for the port and/or the link interface shall be
    turned on.
    The state of the device port after the operation is returned in appropriate
    fields of the sata_device structure passed as the function argument.
    The call to sata_tran_port_activate() may be followed by a call to
    the sata_tran_probe_port() function.

RETURN VALUE
    sata_tran_port_activate() must return:
    
    SATA_SUCCESS	Specified port was activated and it's status does not
    			indicate any error. It does not matter if a device was
    			attached or not. If a device was attached,
    			the communication link with a device was established.
    			The state field in the sata_device structure passed as
    			the argument should be set to SATA_STATE_READY. The
    			status registers of the device port should be returned
    			in appropriate fields of the sata_device structure
    			passed as the argument to the function.
    			
      SATA_FAILURE	Specified port was not activated or it's status
      			indicates some failure condition. If the state of the
      			port is known, the state field in the sata_device
      			structure passed as the argument should be set to
      			SATA_PSTATE_SHUTDOWN and the status registers of the
      			device port should be returned in  appropriate fields
      			of the sata_device structure. If the state of the port
      			is not known, the state field should be set to
      			SATA_STATE_UNKNOWN.  If the requested operation
      			rendered port unusable the state field should be set
      			to SATA_PSTATE_FAILED.

SEE ALSO
    sata_hba_tran(9S), sata_hba_init(9F), sata_hba_fini(9F), 
    sata_hba_attach(9F), sata_hba_detach(9F), sata_hba_event_notify(9F), 
    sata_tran_probe_port(9F), sata_tran_start(9F), sata_tran_abort(9f),
    sata_tran_self_test(9F), sata_tran_hotplug_ops(9S),
    sata_tran_port_deactivate(9S),
    sata_tran_pwrmgt_ops(9S), sata_tran_ioctl(9F), sata_address(9S),
    sata_device(9S), sata_pkt(9S)