SCSI Target Mode Framework Library Functions
                                   stmfGetProviderDataProt(3STMF)



NAME
     stmfGetProviderDataProt - retrieve data  for  the  specified
     provider

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

     int stmfGetProviderDataProt(char *providerName, nvlistt **nvl,
          int providerType, uint64t *token);


PARAMETERS
     providerName    The name of the provider for which  data  is
                     being retrieved.


     nvl             A pointer to a pointer to  an  nvlistt.  On
                     success,   this   will  contain  the  nvlist
                     retrieved. The  caller  is  responsible  for
                     freeing   the  returned  nvlist  by  calling
                     nvlistfree(3NVPAIR).


     providerType    The value for this parameter must be  either
                     STMFLUPROVIDERTYPE                     or
                     STMFPORTPROVIDERTYPE.


     token           A pointer to a  uint64t  allocated  by  the
                     caller.  On  success,  this  will  contain a
                     token for the returned data that can be used
                     in  a call to stmfSetProviderDataProt(3STMF)
                     to ensure that the  data  returned  in  this
                     call  is  not  stale. If this value is NUL,
                     the token will be ignored.


DESCRIPTION
     The stmfGetProviderDataProt() function  retrieves  the  data
     for the specified provider.

RETURN VALUES
     The following values are returned:

     STMFERORNOMEM       The library was  unable  to  allocate
                            sufficient memory to return the data.


     STMFSTATUSUCES    The API call was successful.




SunOS 5.11           Last change: 7 Oct 2008                    1






SCSI Target Mode Framework Library Functions
                                   stmfGetProviderDataProt(3STMF)



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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     libstmf(3LIB),                         nvlistfree(3NVPAIR),
     stmfSetProviderDataProt(3STMF), attributes(5)




































SunOS 5.11           Last change: 7 Oct 2008                    2






SCSI Target Mode Framework Library Functions
                                   stmfGetProviderDataProt(3STMF)






















































SunOS 5.11           Last change: 7 Oct 2008                    3