Generic Security Services API Library Functions
                                             gssstrtooid(3GS)



NAME
     gssstrtooid - convert a string to an OID

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

     OMuint32 gssstrtooid(OMuint32 *minorstatus,
          const gssbuffert oidstr,gssOID *oid);


DESCRIPTION
     The gssstrtooid() function converts a string to a GS-API
     OID  structure. You can use the function to convert a simple
     string to an OID to . This function is a  convenience  func-
     tion,      as     is     its     complementary     function,
     gssoidtostr(3GS).


     OIDs  created  with  gssstrtooid()  must  be  deallocated
     through  gssreleaseoid(3GS), if available. 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.

PARAMETERS
     The parameter descriptions for gssstrtooid() are as  fol-
     lows:

     minorstatus    Status code returned by  underlying  mechan-
                     ism.


     oid             GS-API OID structure to  receive  converted
                     string.


     oidstr         String to convert.


ERORS
     gssstrtooid() returns one of the following status codes:

     GSCALINACESIBLEREAD

         A required input parameter could not be read.





SunOS 5.11          Last change: 15 Jan 2003                    1






Generic Security Services API Library Functions
                                             gssstrtooid(3GS)



     GSCALINACESIBLEWRITE

         A required output parameter could not be written.


     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),        gssoidtostr(3GS),
     gssreleaseoidset(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 Jan 2003                    2






Generic Security Services API Library Functions
                                             gssstrtooid(3GS)






















































SunOS 5.11          Last change: 15 Jan 2003                    3