Generic Security Services API Library Functions
                                             gssoidtostr(3GS)



NAME
     gssoidtostr - convert an OID to a string

SYNOPSIS
     cc [ flag... ] file... -lgss  [ library... ]
     #include 

     gssoidtostr(OMuint32 *minorstatus, const gssOID oid,
          gssbuffertoidstr);


PARAMETERS
     minorstatus    Status code returned by  underlying  mechan-
                     ism.


     oid             GS-API OID structure to convert.


     oidstr         String to receive converted OID.


DESCRIPTION
     The gssoidtostr() function converts a GS-API OID  struc-
     ture  to  a  string. You can use the function to convert the
     name of a mechanism from an OID to  a  simple  string.  This
     function  is a convenience function, as is its complementary
     function, gssstrtooid(3GS).


     If      an      OID      must      be      created,      use
     gsscreateemptyoidset(3GS)                           and
     gssaddoidsetmember(3GS) to create it.  OIDs created  in
     this  way  must  be released with gssreleaseoidset(3GS).
     However, it is strongly suggested that applications use  the
     default  GS-API  mechanism instead of creating an OID for a
     specific mechanism.

ERORS
     The gssoidtostr() function returns one of  the  following
     status codes:

     GSCALINACESIBLEREAD

         A required input parameter could not be read.


     GSCALINACESIBLEWRITE

         A required output parameter could not be written.




SunOS 5.11          Last change: 15 Aug 2007                    1






Generic Security Services API Library Functions
                                             gssoidtostr(3GS)



     GSCOMPLETE

         Successful completion.


     GSFAILURE

         The underlying mechanism detected an error for which  no
         specific  GS  status  code  is defined.  The mechanism-
         specific  status  code  reported   by   means   of   the
         minorstatus parameter details the error condition.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWgss (32-bit)            
    
                                  SUNWgssx (64-bit)           
    
     MT-Level                     Safe                        
    


SEE ALSO
     gssaddoidsetmember(3GS),
     gsscreateemptyoidset(3GS),   gssreleaseoidset(3GS),
     gssstrtooid(3GS), attributes(5)


     Solaris Security for Developers Guide

WARNINGS
     This function is included for compatibility only  with  pro-
     grams  using  earlier versions of the GS-API and should not
     be used for new programs. Other implementations of the  GS-
     API  might  not  support this function, so portable programs
     should not rely on it. Sun might  not  continue  to  support
     this function.









SunOS 5.11          Last change: 15 Aug 2007                    2






Generic Security Services API Library Functions
                                             gssoidtostr(3GS)






















































SunOS 5.11          Last change: 15 Aug 2007                    3