1stmfGetProviderDatSaCPSrIotT(a3rSgTeMtF)Mode Framework LibrasrtymfFGuentcPtrioovnisderDataProt(3STMF)
2
3
4

NAME

6       stmfGetProviderDataProt - retrieve data for the specified provider
7

SYNOPSIS

9       cc [ flag... ] file... -lstmf [ library... ]
10        #include <libstmf.h>
11
12       int stmfGetProviderDataProt(char *providerName, nvlist_t **nvl,
13            int providerType, uint64_t *token);
14
15

PARAMETERS

17       providerName    The  name  of  the  provider  for  which  data is being
18                       retrieved.
19
20
21       nvl             A pointer to a pointer to an nvlist_t. On success, this
22                       will  contain  the  nvlist  retrieved.  The  caller  is
23                       responsible for freeing the returned nvlist by  calling
24                       nvlist_free(3NVPAIR).
25
26
27       providerType    The   value   for   this   parameter   must  be  either
28                       STMF_LU_PROVIDER_TYPE or STMF_PORT_PROVIDER_TYPE.
29
30
31       token           A pointer to a uint64_t allocated  by  the  caller.  On
32                       success,  this  will  contain  a token for the returned
33                       data that can be used in a call to  stmfSetProviderDat‐
34                       aProt(3STMF)  to  ensure that the data returned in this
35                       call is not stale. If this value  is  NULL,  the  token
36                       will be ignored.
37
38

DESCRIPTION

40       The stmfGetProviderDataProt() function retrieves the data for the spec‐
41       ified provider.
42

RETURN VALUES

44       The following values are returned:
45
46       STMF_ERROR_NOMEM       The library was unable  to  allocate  sufficient
47                              memory to return the data.
48
49
50       STMF_STATUS_SUCCESS    The API call was successful.
51
52

ATTRIBUTES

54       See attributes(5) for descriptions of the following attributes:
55
56
57
58
59       ┌─────────────────────────────┬─────────────────────────────┐
60       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
61       ├─────────────────────────────┼─────────────────────────────┤
62       │Interface Stability          │Committed                    │
63       ├─────────────────────────────┼─────────────────────────────┤
64       │MT-Level                     │Safe                         │
65       └─────────────────────────────┴─────────────────────────────┘
66

SEE ALSO

68       libstmf(3LIB),   nvlist_free(3NVPAIR),  stmfSetProviderDataProt(3STMF),
69       attributes(5)
70
71
72
73SunOS 5.11                        7 Oct 2008    stmfGetProviderDataProt(3STMF)
Impressum