1rpc_gss_get_error(3NSLN)etworking Services Library Functiornpsc_gss_get_error(3NSL)
2
3
4

NAME

6       rpc_gss_get_error - get error codes on failure
7

SYNOPSIS

9       #include <rpc/rpcsec_gss.h>
10
11       bool_t rpc_gss_get_error(rpc_gss_error_t*error);
12
13

DESCRIPTION

15       rpc_gss_get_error()  fetches  an  error code when an RPCSEC_GSS routine
16       fails.
17
18
19       rpc_gss_get_error() uses a rpc_gss_error_t structure of  the  following
20       form:
21
22         typedef struct {
23         int  rpc_gss_error;      RPCSEC_GSS error
24         int  system_error;       system error
25         } rpc_gss_error_t;
26
27
28
29       Currently the only error codes defined for this function are
30
31         #define RPC_GSS_ER_SUCCESS         0    /* no error */
32         #define RPC_GSS_ER_SYSTEMERROR     1    /* system error */
33
34

PARAMETERS

36       Information on RPCSEC_GSS data types for parameters may be found on the
37       rpcsec_gss(3NSL) man page.
38
39       error     A  rpc_gss_error_t structure.  If the rpc_gss_error field  is
40                 equal  to   RPC_GSS_ER_SYSTEMERROR,  the   system_error field
41                 will be set to the value of errno.
42
43

RETURN VALUES

45       Unless there is a failure indication from an invoked  RPCSEC_GSS  func‐
46       tion,  rpc_gss_get_error() does not set error to a meaningful value.
47

ATTRIBUTES

49       See attributes(5) for descriptions of the following attributes:
50
51
52
53
54       ┌─────────────────────────────┬─────────────────────────────┐
55       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
56       ├─────────────────────────────┼─────────────────────────────┤
57       │MT-Level                     │MT-Safe                      │
58       ├─────────────────────────────┼─────────────────────────────┤
59       │Availability                 │SUNWrsg (32-bit)             │
60       ├─────────────────────────────┼─────────────────────────────┤
61       │                             │SUNWrsgx (64-bit)            │
62       └─────────────────────────────┴─────────────────────────────┘
63

SEE ALSO

65       perror(3C), rpc(3NSL), rpcsec_gss(3NSL), attributes(5)
66
67
68       ONC+ Developer's Guide
69
70
71       Linn,  J. RFC 2078, Generic Security Service Application Program Inter‐
72       face, Version 2. Network Working Group. January 1997.
73

NOTES

75       Only system errors are currently returned.
76
77
78
79SunOS 5.11                        5 Feb 2002           rpc_gss_get_error(3NSL)
Impressum