rpc_gss_get_mech_info(3n) [hpux man page]

rpc_gss_get_mechanisms(3N)												rpc_gss_get_mechanisms(3N)

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


DESCRIPTION

       These "convenience functions" return information on available security mechanisms and versions of

       Returns a list of supported security mechanisms as a null-terminated
	      list of character strings.

       Takes two arguments: an ASCII string representing a mechanism type
	      (for example, and a pointer to a will return NULL upon error or if no 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.

       Returns the highest and lowest versions of
	      supported.

       Takes an ASCII string representing a mechanism, and returns
	      if the mechanism is installed.

PARAMETERS

       Information on data types for parameters may be found on the rpcsec_gss(3N) manpage.

       mech	 An ASCII string representing the security mechanism in use.  Valid strings may also be found in the file.

       service	 A pointer to a representing the current security service (privacy, integrity, or none).

       vers_hi, vers_lo
		 The highest and lowest versions of supported.

MULTITHREAD USAGE

       Thread Safe:	     Yes
       Cancel Safe:	     Yes
       Fork Safe:	     No
       Async-cancel Safe:    No
       Async-signal Safe:    No

       These functions can be called safely in a multithreaded environment.  They may be cancellation points in that they call functions that  are
       cancel points.

       In a multithreaded environment, these functions are not safe to be called by a child process after and before These functions should not be
       called by a multithreaded application that supports asynchronous cancellation or asynchronous signals.

BUGS

       The service argument for is currently irrelevant.

FILES

       File containing valid security mechanisms.

       File containing valid QOP values.

SEE ALSO

       rpc(3N), rpcsec_gss(3N), mech(4), qop(4).

															rpc_gss_get_mechanisms(3N)

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 Protections
				    (QOPs) for this mechanism. NULL or empty list implies only that the default QOP is available and can be speci-
				    fied 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.11							    29 Jun 2001 				      rpc_gss_get_mechanisms(3NSL)