Networking Services Library Functions
                                     rpcgssgetmechanisms(3NSL)



NAME
     rpcgssgetmechanisms,               rpcgssgetmechinfo,
     rpcgssgetversions, rpcgssisinstalled - get information
     on mechanisms and RPC version

SYNOPSIS
     #include 

     char **rpcgssgetmechanisms();


     char **rpcgssgetmechinfo(char *mech, rpcgssservicet *service);


     boolt rpcgssgetversions(uint *vershi, uint *verslo);


     boolt rpcgssis installed(char *mech);


DESCRIPTION
     These "convenience functions" return information  on  avail-
     able security mechanisms and versions of  RPCSECGS .

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


     rpcgssgetmechinfo()      Takes two arguments:  an  ASCI
                                  string representing a mechanism
                                  type, for example,  kerberosv5,
                                  and     a    pointer    to    a
                                  rpcgssservicet         enum.
                                  rpcgssgetmechinfo()    will
                                  return NUL 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. NUL 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 NUL or as an empty string.






SunOS 5.11          Last change: 29 Jun 2001                    1






Networking Services Library Functions
                                     rpcgssgetmechanisms(3NSL)



     rpcgssgetversions()       Returns the highest and  lowest
                                  versions  of   RPCSECGS  sup-
                                  ported.


     rpcgssisinstalled()       Takes    an    ASCI     string
                                  representing  a  mechanism, and
                                  returns TRUE if  the  mechanism
                                  is installed.


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


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


     vershi     The highest and lowest  versions  of  RPCSECGS
     verslo     supported.


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:















SunOS 5.11          Last change: 29 Jun 2001                    2






Networking Services Library Functions
                                     rpcgssgetmechanisms(3NSL)




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


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


     ONC] Developer's Guide


     Linn, J. RFC 2743, Generic Security Service Application Pro-
     gram  Interface  Version 2, Update 1. Network Working Group.
     January 2000.

NOTES
     This function will change in a future release.






























SunOS 5.11          Last change: 29 Jun 2001                    3






Networking Services Library Functions
                                     rpcgssgetmechanisms(3NSL)






















































SunOS 5.11          Last change: 29 Jun 2001                    4