Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Generic Security Services API Library Functionsgss_oid_to_str(3GSS)


NAME

 gss_oid_to_str - convert an OID to a string

SYNOPSIS

 
cc -flag ...  file...-lgss [library ...] 
#include <gssapi/gssapi.h>
gss_oid_to_str(OM_uint32 *minor_status, const gss_OID *oid, gss_buffer_toid_str);

DESCRIPTION

 

The gss_oid_to_str() function converts a GSS-API OID structure 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, gss_str_to_oid(3GSS).

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_oid_to_str() are as follows:

minor_status
Status code returned by underlying mechanism.
oid
GSS-API OID structure to convert.
oid_str
String to receive converted OID.

RETURN VALUES

 

gss_oid_to_str() returns one of the following status codes:

GSS_S_CALL_INACCESSIBLE_READ
A required input parameter could not be read.
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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWgss (32-bit)
 SUNWgssx (64-bit)
MT-LevelSafe

SEE ALSO

 

gss_add_oid_set_member()(3GSS), gss_create_empty_oid_set(3GSS), gss_release_oid_set(3GSS), gss_str_to_oid(3GSS), attributes(5)

GSS-API Programming Guide

WARNINGS

 

This function is included for compatibility only with programs 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.9Go To TopLast Changed 24 Apr 2000

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.