te
 Copyright (C) 2002, Sun Microsystems, Inc. All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 RPC_GSS_MECH_TO_OID 3NSL "Feb 5, 2002"
 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(7) for descriptions of the following attributes:






ATTRIBUTE TYPE ATTRIBUTE VALUE
MT-Level MT-Safe



 SEE ALSO

 rpc (3NSL),  rpc_gss_get_error (3NSL),  rpc_gss_get_mechanisms (3NSL),  rpcsec_gss (3NSL),  mech (5),  qop (5),  attributes (7) 

ONC+ Developer's Guide