rpc_gss_get_mechanismNetworking Services Library Frpc_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
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 Protec‐
tions (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 The highest and lowest versions of RPCSEC_GSS sup‐
vers_lo ported.
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 │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWrsg (32-bit) │
├─────────────────────────────┼─────────────────────────────┤
│ │SUNWrsgx (64-bit) │
└─────────────────────────────┴─────────────────────────────┘
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
This function will change in a future release.
SunOS 5.10 29 Jun 2001 rpc_gss_get_mechanisms(3NSL)