rpc_gss_mech_to_oid(3n) [hpux man page]

rpc_gss_mech_to_oid(3N) 												   rpc_gss_mech_to_oid(3N)

NAME

       rpc_gss_mech_to_oid(), rpc_gss_qop_to_num() - map mechanism, QOP strings to non-string values

SYNOPSIS


DESCRIPTION

       Because in-kernel RPC routines use non-string values for mechanism and Quality of Protection (QOP), these routines exist to map strings for
       these attributes to their non-string counterparts.  (The non-string values for QOP and mechanism are also found in the and  files,  respec-
       tively.)   takes  a  string  representing a mechanism, as well as a pointer to a object identifier structure.  It then gives this structure
       values corresponding to the indicated mechanism, so that the application can now use the OID directly with RPC  routines.   does  much  the
       same thing, taking strings for QOP and mechanism and returning a number.

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 be found in the file.

       oid	 An object identifier of type whose elements are usable by kernel-level RPC routines.

       qop	 This  is  an  ASCII string which sets the quality of protection (QOP) for the session.  Appropriate values for this string may be
		 found in the file

       num	 The non-string value for the QOP.

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.

RETURN VALUE

       Both functions return if they are successful, otherwise.

FILES

       File containing valid security mechanisms.

       File containing valid QOP values.

SEE ALSO

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

															   rpc_gss_mech_to_oid(3N)

rpc_gss_mech_to_oid(3NSL)			       Networking Services Library Functions				 rpc_gss_mech_to_oid(3NSL)

NAME

       rpc_gss_mech_to_oid, rpc_gss_qop_to_num - map mechanism, QOP strings to non-string values

SYNOPSIS

       #include <rpc/rpcsec_gss.h>

       bool_t rpc_gss_mech_to_oid(charc*mech, rpc_gss_OIDc*oid);

       bool_t rpc_gss_qop_to_num(char *qop, char *mech, u_int *num);

DESCRIPTION

       Because in-kernel RPC routines use non-string values for mechanism and Quality of Protection (QOP), these routines exist to map strings for
       these attributes to their non-string counterparts.   (The non-string values for QOP and mechanism are also found in  the  /etc/gss/qop  and
       /etc/gss/mech  files,  respectively.)  rpc_gss_mech_to_oid() takes a string representing a mechanism, as well as a pointer to a rpc_gss_OID
       object identifier structure.  It then gives this structure values corresponding to the indicated mechanism, so that the application can now
       use the OID directly with RPC routines. rpc_gss_qop_to_num() does much the same thing, taking strings for QOP and mechanism and returning a
       number.

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 be found in the /etc/gss/mech file.

       oid	       An object identifier of type rpc_gss_OID, whose elements are usable by kernel-level RPC routines.

       qop	       This is an ASCII string which sets the quality of protection (QOP) for the session. Appropriate values for this string  may
		       be found in the file /etc/gss/qop.

       num	       The non-string value for the QOP.

RETURN VALUES

       Both functions return TRUE if they are successful, FALSE otherwise.

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), rpc_gss_get_error(3NSL), rpc_gss_get_mechanisms(3NSL), rpcsec_gss(3NSL), mech(4), qop(4), attributes(5)

       ONC+ Developer's Guide

       Linn, J. RFC 2078, Generic Security Service Application Program Interface, Version 2. Network Working Group. January 1997.

SunOS 5.10							    5 Feb 2002						 rpc_gss_mech_to_oid(3NSL)