RPC_GSS_GET_MECHANISMS(3NSL)RPC_GSS_GET_MECHANISMS(3NSL)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 mech‐
anisms as a null-terminated list of char‐
acter strings.
rpc_gss_get_mech_info()
Takes two arguments: an ASCII string rep‐
resenting 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-ter‐
minated list of character strings of sup‐
ported 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 mech‐
anism, 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(5) for descriptions of the following attributes:
┌───────────────┬─────────────────┐
│ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├───────────────┼─────────────────┤
│MT-Level │ MT-Safe │
└───────────────┴─────────────────┘
SEE ALSOrpc(3NSL),rpcsec_gss(3NSL), mech(4), qop(4), attributes(5)
ONC+ Developer's Guide
Linn, J. RFC 2743, Generic Security Service Application Program Inter‐
face Version 2, Update 1. Network Working Group. January 2000.
NOTES
Jun 29, 2001 RPC_GSS_GET_MECHANISMS(3NSL)
