


   SPX Version 2.2                                        gss_acquire_cred(3)



   Name
     gss_acquire_cred - acquire pre-existing credentials

   Syntax
     #include "gssapi_defs.h"

     OM_uint32 gss_acquire_cred(minor_status,
                                desired_name,
                                time_req,
                                desired_mechs,
                                cred_usage,
                                output_cred_handle,
                                actual_mechs,
                                time_rec)

     OM_uint32       *minor_status;
     gss_name_t      desired_name;
     OM_uint32       time_req;
     gss_OID_set     desired_mechs;
     int             cred_usage;
     gss_cred_id_t   *output_cred_handle;
     gss_OID_set     *actual_mechs;
     OM_uint32       *time_rec;

   Arguments

     _m_i_n_o_r__s_t_a_t_u_s
            (OM_uint32, modify) If the routine doesn't return GSS_S_COMPLETE,
            then this status code can be used to display the mechanism
            specific error using the call _g_s_s__d_i_s_p_l_a_y__s_t_a_t_u_s

     _d_e_s_i_r_e_d__n_a_m_e
            (gss_name_t, read) Name of the principal whose credential should
            be acquired.

     _t_i_m_e__r_e_q
            (OM_uint32, read) Number of seconds for which the credentials are
            to be valid.  Specify NULL if this information is not required.

     _d_e_s_i_r_e_d__m_e_c_h_s
            (gss_OID_set, read) Set of underlying security mechanisms that
            are available.  Use GSS_C_NULL_OID_SET to obtain SPX as the
            default security mechanism.

     _c_r_e_d__u_s_a_g_e
            (integer, read)  One of the following:

              _G_S_S__C__B_O_T_H
                     Credentials can be used both to initiate and accept
                     security contexts.

              _G_S_S__C__I_N_I_T
                     Credentials can be used only to initiate security


   Digital Equipment Corporation                                            1






   gss_acquire_cred(3)                                        SPX Version 2.2


                     contexts.

              _G_S_S__C__A_C_C_E_P_T
                     Credentials can be used only to accept security con-
                     texts.

     _o_u_t_p_u_t__c_r_e_d__h_a_n_d_l_e
            (gss_cred_id_t, modify) The returned credential handle.

     _a_c_t_u_a_l__m_e_c_h_s
            (gss_OID_set, modify) The set of mechanisms for which the creden-
            tial is valid.  SPX is the only supported mechanism.

     _t_i_m_e__r_e_c
            (OM_uint32, modify) Actual number of seconds for which the
            returned credentials are to be valid.  Specify NULL if this
            information is not required.

   Description
     Allows an application to acquire pre-existing credentials by name.  The
     caller should later delete _c_r_e_d__h_a_n_d_l_e with a call to _g_s_s__r_e_l_e_a_s_e__c_r_e_d

   See Also

































   2                                            Digital Equipment Corporation


99