Manual Pages for UNIX Operating System command usage for man gss_str_to_oid

Generic Security Services API Library Functions
                                             gss_str_to_oid(3GSS)



NAME
     gss_str_to_oid - convert a string to an OID

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

     OM_uint32 gss_str_to_oid(OM_uint32 *minor_status,
          const gss_buffer_t oid_str,gss_OID *oid);


DESCRIPTION
     The gss_str_to_oid() function converts a string to a GSS-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,
     gss_oid_to_str(3GSS).


     OIDs  created  with  gss_str_to_oid()  must  be  deallocated
     through  gss_release_oid(3GSS), if available. If an OID must
     be   created,   use    gss_create_empty_oid_set(3GSS)    and
     gss_add_oid_set_member(3GSS)  to  create it. OIDs created in
     this way must be  released  with  gss_release_oid_set(3GSS).
     However,  it is strongly suggested that applications use the
     default GSS-API mechanism instead of creating an OID  for  a
     specific mechanism.

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

     minor_status    Status code returned by  underlying  mechan-
                     ism.


     oid             GSS-API OID structure to  receive  converted
                     string.


     oid_str         String to convert.


ERRORS
     gss_str_to_oid() returns one of the following status codes:

     GSS_S_CALL_INACCESSIBLE_READ

         A required input parameter could not be read.





SunOS 5.11          Last change: 15 Jan 2003                    1






Generic Security Services API Library Functions
                                             gss_str_to_oid(3GSS)



     GSS_S_CALL_INACCESSIBLE_WRITE

         A required output parameter could not be written.


     GSS_S_COMPLETE

         Successful completion.


     GSS_S_FAILURE

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


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



     ____________________________________________________________________
    |       ATTRIBUTE TYPE        |           ATTRIBUTE VALUE           |
    |_____________________________|_____________________________________|
    | Availability                | system/library/security/gss (32-bit)|
    |_____________________________|_____________________________________|
    |                             | SUNWgssx (64-bit)                   |
    |_____________________________|_____________________________________|
    | MT Level                    | Safe                                |
    |_____________________________|_____________________________________|


SEE ALSO
     gss_add_oid_set_member(3GSS),
     gss_create_empty_oid_set(3GSS),        gss_oid_to_str(3GSS),
     gss_release_oid_set(3GSS), attributes(5)


     Oracle Solaris Security for Developers Guide

WARNINGS
     This function is included for compatibility only  with  pro-
     grams  using  earlier versions of the GSS-API and should not
     be used for new programs. Other implementations of the  GSS-
     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
                                             gss_str_to_oid(3GSS)






















































SunOS 5.11          Last change: 15 Jan 2003                    3