rpc_gss_get_mech_info(3nsl)

1rpc_gss_get_mechanismsN(e3tNwSoLr)king Services Library Furnpcct_igosnss_get_mechanisms(3NSL)
2
3
4

NAME

6       rpc_gss_get_mechanisms,   rpc_gss_get_mech_info,  rpc_gss_get_versions,
7       rpc_gss_is_installed - get information on mechanisms and RPC version
8

SYNOPSIS

10       #include <rpc/rpcsec_gss.h>
11
12       char **rpc_gss_get_mechanisms();
13
14
15       char **rpc_gss_get_mech_info(char *mech, rpc_gss_service_t *service);
16
17
18       bool_t rpc_gss_get_versions(u_int *vers_hi, u_int *vers_lo);
19
20
21       bool_t rpc_gss_is installed(char *mech);
22
23

DESCRIPTION

25       These "convenience functions" return information on available  security
26       mechanisms and versions of  RPCSEC_GSS .
27
28       rpc_gss_get_mechanisms()     Returns a list of supported security mech‐
29                                    anisms as a null-terminated list of  char‐
30                                    acter strings.
31
32
33       rpc_gss_get_mech_info()      Takes two arguments:  an ASCII string rep‐
34                                    resenting a mechanism type,  for  example,
35                                    kerberosv5,    and    a   pointer   to   a
36                                    rpc_gss_service_t                    enum.
37                                    rpc_gss_get_mech_info()  will  return NULL
38                                    upon error or if no /etc/gss/qop  file  is
39                                    present. Otherwise, it returns a null-ter‐
40                                    minated list of character strings of  sup‐
41                                    ported  Quality  of Protections (QOPs) for
42                                    this mechanism. NULL or empty list implies
43                                    only that the default QOP is available and
44                                    can be specified to routines that need  to
45                                    take  a QOP string parameter as NULL or as
46                                    an empty string.
47
48
49       rpc_gss_get_versions()       Returns the highest and lowest versions of
50                                    RPCSEC_GSS supported.
51
52
53       rpc_gss_is_installed()       Takes an ASCII string representing a mech‐
54                                    anism, and returns TRUE if  the  mechanism
55                                    is installed.
56
57

PARAMETERS

59       Information on RPCSEC_GSS data types for parameters may be found on the
60       rpcsec_gss(3NSL) man page.
61
62       mech        An ASCII string representing the security mechanism in use.
63                   Valid strings may also be found in the /etc/gss/mech file.
64
65
66       service     A  pointer  to  a  rpc_gss_service_t enum, representing the
67                   current security service (privacy, integrity, or none).
68
69
70       vers_hi     The highest and lowest versions of RPCSEC_GSS supported.
71       vers_lo
72

FILES

74       /etc/gss/mech     File containing valid security mechanisms
75
76
77       /etc/gss/qop      File containing valid QOP values
78
79

ATTRIBUTES

81       See attributes(5) for descriptions of the following attributes:
82
83
84
85
86       ┌─────────────────────────────┬─────────────────────────────┐
87       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
88       ├─────────────────────────────┼─────────────────────────────┤
89       │MT-Level                     │MT-Safe                      │
90       ├─────────────────────────────┼─────────────────────────────┤
91       │Availability                 │SUNWrsg (32-bit)             │
92       ├─────────────────────────────┼─────────────────────────────┤
93       │                             │SUNWrsgx (64-bit)            │
94       └─────────────────────────────┴─────────────────────────────┘
95

NOTES

107       This function will change in a future release.
108
109
110
111SunOS 5.11                        29 Jun 2001     rpc_gss_get_mechanisms(3NSL)