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)