RPC_GSS_GET_MECHANISMS(3NSL) Networking Services Library Functions

NAME

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

SYNOPSIS

#include <rpc/rpcsec_gss.h>

char **rpc_gss_get_mechanisms();


char **rpc_gss_get_mech_info(char *mech, rpc_gss_service_t *service);


bool_t rpc_gss_get_versions(u_int *vers_hi, u_int *vers_lo);


bool_t rpc_gss_is installed(char *mech);

DESCRIPTION

These "convenience functions" return information on available security
mechanisms and versions of RPCSEC_GSS .

rpc_gss_get_mechanisms()
Returns a list of supported security
mechanisms as a null-terminated list of
character strings.


rpc_gss_get_mech_info()
Takes two arguments: an ASCII string
representing a mechanism type, for example,
kerberosv5, and a pointer to a
rpc_gss_service_t enum.
rpc_gss_get_mech_info() will return NULL
upon error or if no /etc/gss/qop file is
present. Otherwise, it returns a null-
terminated list of character strings of
supported Quality of Protections (QOPs) for
this mechanism. NULL or empty list implies
only that the default QOP is available and
can be specified to routines that need to
take a QOP string parameter as NULL or as an
empty string.


rpc_gss_get_versions()
Returns the highest and lowest versions of
RPCSEC_GSS supported.


rpc_gss_is_installed()
Takes an ASCII string representing a
mechanism, and returns TRUE if the mechanism
is installed.

PARAMETERS

Information on RPCSEC_GSS data types for parameters may be found on the
rpcsec_gss(3NSL) man page.

mech
An ASCII string representing the security mechanism in use.
Valid strings may also be found in the /etc/gss/mech file.


service
A pointer to a rpc_gss_service_t enum, representing the
current security service (privacy, integrity, or none).


vers_hi
vers_lo
The highest and lowest versions of RPCSEC_GSS supported.

FILES

/etc/gss/mech
File containing valid security mechanisms


/etc/gss/qop
File containing valid QOP values

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+

SEE ALSO

rpc(3NSL), rpcsec_gss(3NSL), mech(5), qop(5), attributes(7)


ONC+ Developer's Guide


Linn, J. RFC 2743, Generic Security Service Application Program Interface
Version 2, Update 1. Network Working Group. January 2000.

NOTES

June 29, 2001 RPC_GSS_GET_MECHANISMS(3NSL)