rpc_gss_get_mech_info(3nsl) [plan9 man page]
rpc_gss_get_mechanisms(3NSL) Networking Services Library Functions 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 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 Pro- tections (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 supported. vers_lo 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 ALSO
rpc(3NSL),rpcsec_gss(3NSL), mech(4), qop(4), attributes(5) ONC+ Developer's Guide Linn, J. RFC 2743, Generic Security Service Application Program Interface 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)
Check Out this Related Man Page
rpc_gss_get_mechanisms(3NSL) Networking Services Library Functions 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 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 Pro- tections (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 supported. vers_lo 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 ALSO
rpc(3NSL),rpcsec_gss(3NSL), mech(4), qop(4), attributes(5) ONC+ Developer's Guide Linn, J. RFC 2743, Generic Security Service Application Program Interface 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)