following:
                           GSS_C_INITIATE
                           GSS_C_ACCEPT
                           GSS_C_BOTH
                        Specify NULL if not required.

      mechanisms        gss_OID_set, modify
                        Set of mechanisms supported by the credential.
                        Specify NULL if not required.

   Function value:

      GSS status code

      GSS_S_COMPLETE    Successful completion

      GSS_S_NO_CRED     The referenced credentials could not be
                        accessed.

      GSS_S_DEFECTIVE_CREDENTIAL The referenced credentials were
                        invalid.

      GSS_S_CREDENTIALS_EXPIRED The referenced credentials have expired.
                        If the lifetime parameter was not passed as
                        NULL, it will be set to 0.


  #ifndef GSSAPI_H_
  #define GSSAPI_H_

  /*
   * First, define the platform-dependent types.
   */
  typedef <platform-specific> OM_uint32;
  typedef <platform-specific> gss_ctx_id_t;
  typedef <platform-specific> gss_cred_id_t;
  typedef <platform-specific> gss_name_t;





 
RFC 1509            GSSAPI - Overview and C bindings      September 1993


  /*
   * Note that a platform supporting the xom.h X/Open header file
   * may make use of that header for the definitions of OM_uint32
   * and the structure to which gss_OID_desc equates.
   */

  typedef struct gss_OID_desc_struct {
        OM_uint32 length;
        void      *elements;
  } gss_OID_desc, *gss_OID;

  typedef struct gss_OID_set_desc_struct  {
        int     count;
        gss_OID elements;
  } gss_OID_set_desc, *gss_OID_set;

  typedef struct gss_buffer_desc_struct {
        size_t length;
        void *value;
  } gss_buffer_desc, *gss_buffer_t;

  typedef struct gss_channel_bindings_struct {
        OM_uint32 initiator_addrtype;
        gss_buffer_desc initiator_address;
        OM_uint32 acceptor_addrtype;
        gss_buffer_desc acceptor_address;
        gss_buffer_desc application_data;
  } *gss_channel_bindings_t;


  /*
   * Six independent flags each of which indicates that a context
   * supports a specific service option.
   */
  #define GSS_C_DELEG_FLAG 1
  #define GSS_C_MUTUAL_FLAG 2
  #define GSS_C_REPLAY_FLAG 4
  #define GSS_C_SEQUENCE_FLAG 8
  #define GSS_C_CONF_FLAG 16
  #define GSS_C_INTEG_FLAG 32


  /*
   * Credential usage options
   */
  #define GSS_C_BOTH 0
  #define GSS_C_INITIATE 1
  #define GSS_C_ACCEPT 2




 
RFC 1509            GSSAPI - Overview and C bindings      September 1993