x11r4 man page for rpc_gss_get_mechanisms

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)