Content-type: text/html Man page of rpc_gss_mech_to_oid

rpc_gss_mech_to_oid

Section: Networking Services Library Functions (3NSL)
Updated: 5 Feb 2002
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
MT-LevelMT-Safe
AvailabilitySUNWrsg (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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
RETURN VALUES
FILES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:38:45 GMT, October 02, 2010