Networking Services Library Functions   rpcgssmechtooid(3NSL)



NAME
     rpcgssmechtooid, rpcgssqoptonum - map mechanism, QOP
     strings to non-string values

SYNOPSIS
     #include 

     boolt rpcgssmechtooid(charc*mech, rpcgssOIDc*oid);


     boolt rpcgssqoptonum(char *qop, char *mech, uint *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.)  rpcgssmechtooid()
     takes a string  representing  a  mechanism,  as  well  as  a
     pointer  to  a  rpcgssOID object identifier structure.  It
     then gives this structure values corresponding to the  indi-
     cated mechanism, so that the application can now use the OID
     directly with RPC routines. rpcgssqoptonum()  does  much
     the  same  thing,  taking  strings for QOP and mechanism and
     returning a number.

PARAMETERS
     Information on RPCSECGS data types for parameters  may  be
     found on the rpcsecgss(3NSL) man page.

     mech     An ASCI string representing the security mechanism
              in   use.   Valid  strings  may  be  found  in  the
              /etc/gss/mech file.


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


     qop      This is an ASCI 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




SunOS 5.11           Last change: 5 Feb 2002                    1






Networking Services Library Functions   rpcgssmechtooid(3NSL)



     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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    
     Availability                 SUNWrsg (32-bit)            
    
                                  SUNWrsgx (64-bit)           
    


SEE ALSO
     rpc(3NSL),                          rpcgssgeterror(3NSL),
     rpcgssgetmechanisms(3NSL),   rpcsecgss(3NSL),   mech(4),
     qop(4), attributes(5)


     ONC] Developer's Guide


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
















SunOS 5.11           Last change: 5 Feb 2002                    2