Manual Pages for UNIX Operating System command usage for man srpt_SetTargetState

SRP Target Management Library          srpt_SetTargetState(3SRPT)



NAME
     srpt_SetTargetState, srpt_GetTargetState, srpt_ResetTarget -
     set and retrieve SRP Target state for a specific HCA

SYNOPSIS
     cc [ flag... ] file... -lsrpt [ library... ]
     #include 

     int srpt_SetTargetState(char *hca_guid, boolean_t enabled);


     int srpt_GetTargetState(char *hca_guid, boolean_t *enabled);


     int srpt_ResetTarget(char *hca_guid);


PARAMETERS
     hc_guid    HCA GUID.  Must be in one of the following forms:

                3BA000100CD18           base hex form


                0003BA000100CD18        base hex form with  lead-
                                        ing zeroes


                hca:3BA000100CD18       form from cfgadm


                eui.0003BA000100CD18    EUI form



     enabled    boolean value indicating whether  a  COMSTAR  SRP
                target should be created for this HCA


DESCRIPTION
     The srpt_SetTargetState() function controls whether  a  COM-
     STAR  SRP  target  will be created for the specified HCA. If
     enabled is B_TRUE, an SRP target will be  created  for  this
     HCA.  If  enabled  is B_FALSE, a target will not be created.
     This function overrides the default setting for the SRP Tar-
     get  service as set by srpt_SetDefaultState(3SRPT). Changing
     the target state takes effect immediately if the SRP  target
     service  is online. Targets set to disabled will be offlined
     and removed; targets set  to  enabled  will  be  immediately
     created.






SunOS 5.11           Last change: 2 Apr 2010                    1






SRP Target Management Library          srpt_SetTargetState(3SRPT)



     The srpt_GetTargetState()  function  retrieves  the  current
     setting for the specified HCA.


     The srpt_ResetTarget()  function  clears  HCA-specific  set-
     tings.  The  service-wide  defaults  will control SRP Target
     creation for this HCA.

RETURN VALUES
     Upon successful completion, these functions return 0. Other-
     wise they return a non-zero value to indicate the error.

ERRORS
     These functions will fail if:

     ENOMEM    Resources could not be allocated.


     EINVAL    A parameter is invalid.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     libsrpt(3LIB), srpt_SetDefaultState(3SRPT), attributes(5)

















SunOS 5.11           Last change: 2 Apr 2010                    2