NAME

       Handle Attributes -

   Typedefs
       typedef struct
           globus_l_gsi_proxy_handle_attrs_s * globus_gsi_proxy_handle_attrs_t"

   Initialize & Destroy
       globus_result_t globus_gsi_proxy_handle_attrs_init (globus_gsi_proxy_handle_attrs_t
           *handle_attrs)
       globus_result_t globus_gsi_proxy_handle_attrs_destroy (globus_gsi_proxy_handle_attrs_t
           handle_attrs)

   Get/Set Key Bits
       globus_result_t globus_gsi_proxy_handle_attrs_set_keybits (globus_gsi_proxy_handle_attrs_t
           handle_attrs, int bits)
       globus_result_t globus_gsi_proxy_handle_attrs_get_keybits (globus_gsi_proxy_handle_attrs_t
           handle_attrs, int *bits)

   Get/Set Initial Prime Number
       globus_result_t globus_gsi_proxy_handle_attrs_set_init_prime
           (globus_gsi_proxy_handle_attrs_t handle_attrs, int prime)
       globus_result_t globus_gsi_proxy_handle_attrs_get_init_prime
           (globus_gsi_proxy_handle_attrs_t handle_attrs, int *prime)

   Get/Set Signing Algorithm
       globus_result_t globus_gsi_proxy_handle_attrs_set_signing_algorithm
           (globus_gsi_proxy_handle_attrs_t handle_attrs, EVP_MD *algorithm)
       globus_result_t globus_gsi_proxy_handle_attrs_get_signing_algorithm
           (globus_gsi_proxy_handle_attrs_t handle_attrs, EVP_MD **algorithm)

   Get/Set Clock Skew Allowable
       globus_result_t globus_gsi_proxy_handle_attrs_set_clock_skew_allowable
           (globus_gsi_proxy_handle_attrs_t handle_attrs, int skew)
       globus_result_t globus_gsi_proxy_handle_attrs_get_clock_skew_allowable
           (globus_gsi_proxy_handle_attrs_t handle_attrs, int *skew)

   Get/Set Key Gen Callback
       globus_result_t globus_gsi_proxy_handle_attrs_get_key_gen_callback
           (globus_gsi_proxy_handle_attrs_t handle_attrs, void(**callback)(int, int, void *))
       globus_result_t globus_gsi_proxy_handle_attrs_set_key_gen_callback
           (globus_gsi_proxy_handle_attrs_t handle_attrs, void(*callback)(int, int, void *))

   Copy Attributes
       globus_result_t globus_gsi_proxy_handle_attrs_copy (globus_gsi_proxy_handle_attrs_t a,
           globus_gsi_proxy_handle_attrs_t *b)

Detailed Description

       Handle attributes are used to control additional features of the GSI Proxy handle.

       These features are operation independent.

       Currently there are no attributes.

       See Also:
           globus_gsi_proxy_handle_t

Typedef Documentation

   typedef struct globus_l_gsi_proxy_handle_attrs_s* globus_gsi_proxy_handle_attrs_t
       Handle Attributes. A GSI Proxy handle attributes type is used to associate immutable
       parameter values with a Handle Management handle. A handle attributes object should be
       created with immutable parameters and then passed to the proxy handle init function
       globus_gsi_proxy_handle_init().

       See Also:
           Handle Management

Function Documentation

   globus_result_t globus_gsi_proxy_handle_attrs_init (globus_gsi_proxy_handle_attrs_t
       *handle_attrs)
       Initialize GSI Proxy Handle Attributes. Initialize proxy handle attributes, which can (and
       should) be associated with a proxy handle. For most purposes, these attributes should
       primarily be used by the proxy handle.

       Currently, no attibute values are initialized.

       Parameters:
           handle_attrs The handle attributes structure to be initialized

       Returns:
           GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is
           returned

       See Also:
           globus_gsi_proxy_handle_attrs_destroy()

       References GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE_ATTRS.

   globus_result_t globus_gsi_proxy_handle_attrs_set_keybits
       (globus_gsi_proxy_handle_attrs_thandle_attrs, intbits)
       Set the length of the public key pair used by the proxy certificate.

       Parameters:
           handle_attrs the attributes to set
           bits the length to set it to (usually 1024)

       Returns:
           GLOBUS_SUCCESS

   globus_result_t globus_gsi_proxy_handle_attrs_set_init_prime
       (globus_gsi_proxy_handle_attrs_thandle_attrs, intprime)
       Set the initial prime number used for generating public key pairs in the RSA algorithm.

       Parameters:
           handle_attrs The attributes to set
           prime The prime number to set it to This value needs to be a prime number

       Returns:
           GLOBUS_SUCCESS

   globus_result_t globus_gsi_proxy_handle_attrs_set_signing_algorithm
       (globus_gsi_proxy_handle_attrs_thandle_attrs, EVP_MD *algorithm)
       Sets the Signing Algorithm to be used to sign the certificate request. In most cases, the
       signing party will ignore this value, and sign with an algorithm of its choice.

       Parameters:
           handle_attrs The proxy handle to set the signing algorithm of
           algorithm The signing algorithm to set

       Returns:
           Returns GLOBUS_SUCCESS if the handle is valid, otherwise an error object is returned.

       References GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE_ATTRS.

   globus_result_t globus_gsi_proxy_handle_attrs_set_clock_skew_allowable
       (globus_gsi_proxy_handle_attrs_thandle_attrs, intskew)
       Sets the clock skew in minutes of the proxy cert request so that time differences between
       hosts won't cause problems. This value defaults to 5 minutes.

       Parameters:
           handle_attrs the handle_attrs containing the clock skew to be set
           skew the amount to skew by (in seconds)

       Returns:
           GLOBUS_SUCCESS if the handle_attrs is valid - otherwise an error is returned.

       References GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE_ATTRS.

   globus_result_t globus_gsi_proxy_handle_attrs_get_key_gen_callback
       (globus_gsi_proxy_handle_attrs_thandle_attrs, void(**)(int, int, void *)callback)
       Get the public/private key generation callback that provides status during the generation
       of the keys.

       Parameters:
           handle_attrs The handle_attrs to get the callback from
           callback The callback from the handle attributes

       Returns:
           GLOBUS_SUCCESS if the handle_attrs is valid, otherwise an error is returned

       References GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE_ATTRS.

   globus_result_t globus_gsi_proxy_handle_attrs_copy (globus_gsi_proxy_handle_attrs_ta,
       globus_gsi_proxy_handle_attrs_t *b)
       Make a copy of GSI Proxy handle attributes.

       Parameters:
           a The handle attributes to copy
           b The copy

       Returns:
           GLOBUS_SUCCESS

       References GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE_ATTRS,
       globus_gsi_proxy_handle_attrs_destroy(), and globus_gsi_proxy_handle_attrs_init().

   globus_result_t globus_gsi_proxy_handle_attrs_destroy
       (globus_gsi_proxy_handle_attrs_thandle_attrs)
       Destroy the GSI Proxy handle attributes.

       Parameters:
           handle_attrs The handle attributes to be destroyed.

       Returns:
           GLOBUS_SUCCESS

       See Also:
           globus_gsi_proxy_handle_attrs_init()

   globus_result_t globus_gsi_proxy_handle_attrs_get_keybits
       (globus_gsi_proxy_handle_attrs_thandle_attrs, int *bits)
       Gets the length of the public key pair used by the proxy certificate.

       Parameters:
           handle_attrs the attributes to get the key length from
           bits the length of the key pair in bits

       Returns:
           GLOBUS_SUCCESS

   globus_result_t globus_gsi_proxy_handle_attrs_get_init_prime
       (globus_gsi_proxy_handle_attrs_thandle_attrs, int *prime)
       Get the initial prime number used for generating the public key pair in the RSA algorithm.

       Parameters:
           handle_attrs The attributes to get the initial prime number from
           prime The initial prime number taken from the attributes

       Returns:
           GLOBUS_SUCCESS

   globus_result_t globus_gsi_proxy_handle_attrs_get_signing_algorithm
       (globus_gsi_proxy_handle_attrs_thandle_attrs, EVP_MD **algorithm)
       Gets the Signing Algorithm to used to sign the certificate request. In most cases, the
       signing party will ignore this value, and sign with an algorithm of its choice.

       Parameters:
           handle_attrs The proxy handle_attrs to get the signing algorithm of
           algorithm Parameter used to return the signing algorithm used

       Returns:
           Returns GLOBUS_SUCCESS if the handle is valid, otherwise an error object is returned.

       References GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE_ATTRS.

   globus_result_t globus_gsi_proxy_handle_attrs_get_clock_skew_allowable
       (globus_gsi_proxy_handle_attrs_thandle_attrs, int *skew)
       Get the allowable clock skew for the proxy certificate.

       Parameters:
           handle_attrs The handle_attrs to get the clock skew from
           skew The allowable clock skew (in seconds) to get from the proxy certificate request.
           This value gets set by the function, so it needs to be a pointer.

       Returns:
           GLOBUS_SUCCESS if the handle_attrs is valid, otherwise an error is returned

       References GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE_ATTRS.

   globus_result_t globus_gsi_proxy_handle_attrs_set_key_gen_callback
       (globus_gsi_proxy_handle_attrs_thandle_attrs, void(*)(int, int, void *)callback)
       Set the public/private key generation callback that provides status during the generation
       of the keys.

       Parameters:
           handle_attrs The handle_attrs to get the callback from
           callback The callback from the handle attributes

       Returns:
           GLOBUS_SUCCESS if the handle_attrs is valid, otherwise an error is returned

       References GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE_ATTRS.

Author

       Generated automatically by Doxygen for globus gsi proxy core from the source code.