gss_add_oid_set_member(3) [debian man page]

gss_add_oid_set_member(3)						gss						 gss_add_oid_set_member(3)

NAME

       gss_add_oid_set_member - API function

SYNOPSIS

       #include <gss.h>

       OM_uint32 gss_add_oid_set_member(OM_uint32 * minor_status, const gss_OID member_oid, gss_OID_set * oid_set);

ARGUMENTS

       OM_uint32 * minor_status
		   (integer, modify) Mechanism specific status code.

       const gss_OID member_oid
		   (Object ID, read) The object identifier to copied into
		     the set.

       gss_OID_set * oid_set
		   (Set of Object ID, modify) The set in which the object
		     identifier should be inserted.

DESCRIPTION

       Add  an	Object Identifier to an Object Identifier set.	This routine is intended for use in conjunction with gss_create_empty_oid_set when
       constructing a set of mechanism OIDs for input to gss_acquire_cred.  The oid_set parameter must refer to an OID-set  that  was  created	by
       GSS-API	(e.g.  a set returned by gss_create_empty_oid_set()). GSS-API creates a copy of the member_oid and inserts this copy into the set,
       expanding the storage allocated to the OID-set's elements array if necessary.  The routine may add the new member OID anywhere  within  the
       elements  array,  and implementations should verify that the new member_oid is not already contained within the elements array; if the mem-
       ber_oid is already present, the oid_set should remain unchanged.

RETURN VALUE

       `GSS_S_COMPLETE`: Successful completion.

REPORTING BUGS

       Report bugs to <bug-gss@gnu.org>.  GNU Generic Security Service home page: http://www.gnu.org/software/gss/ General help  using	GNU  soft-
       ware: http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright (C) 2003-2011 Simon Josefsson.
       Copying	and  distribution  of  this file, with or without modification, are permitted in any medium without royalty provided the copyright
       notice and this notice are preserved.

SEE ALSO

       The full documentation for gss is maintained as a Texinfo manual.  If the info and gss programs are properly installed at  your	site,  the
       command

	      info gss

       should give you access to the complete manual.

gss								       1.0.2						 gss_add_oid_set_member(3)

gss_add_oid_set_member(3GSS)			  Generic Security Services API Library Functions		      gss_add_oid_set_member(3GSS)

NAME

       gss_add_oid_set_member - add an object identifier to an object identifier set

SYNOPSIS

       cc [ flag... ] file... -lgss  [ library... ]
       #include <gssapi/gssapi.h>

       OM_uint32 gss_add_oid_set_member(OM_uint32 *minor_status,
	    const gss_OID member_oid, gss_OID_set *oid_set);

PARAMETERS

       The parameter descriptions for gss_add_oid_set_member() follow:

       minor_status    A mechanism specific status code.

       member_oid      Object identifier to be copied into the set.

       oid_set	       Set in which the object identifier should be inserted.

DESCRIPTION

       The  gss_add_oid_set_member()  function	adds an object identifier to an object identifier set. You should use this function in conjunction
       with gss_create_empty_oid_set(3GSS) when constructing a set of mechanism OIDs for input to gss_acquire_cred(3GSS).  The	oid_set  parameter
       must refer to an OID-set created by GSS-API, that is, a set returned by gss_create_empty_oid_set(3GSS).

       The  GSS-API  creates  a copy of the member_oid and inserts this copy into the set, expanding the storage allocated to the OID-set elements
       array, if necessary.  New members are always added to the end of the OID set's elements. If the member_oid is already present, the  oid_set
       should remain unchanged.

ERRORS

       The gss_add_oid_set_member() function can return the following status codes:

       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 TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgss (32-bit)		   |
       +-----------------------------+-----------------------------+
       |			     |SUNWgssx (64-bit) 	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       gss_acquire_cred(3GSS), gss_create_empty_oid_set(3GSS), attributes(5)

       Solaris Security for Developers Guide

SunOS 5.11							    16 Aug 2007 				      gss_add_oid_set_member(3GSS)