trusty (3) proxycertinfo.3.gz

Provided by: libglobus-gsi-proxy-ssl-doc_4.1-5_all bug

NAME

       ProxyCertInfo -

   Data Structures
       struct PROXYCERTINFO_st

   ASN1_METHOD
       ASN1_METHOD * PROXYCERTINFO_asn1_meth ()

   New
       PROXYCERTINFO * PROXYCERTINFO_new ()

   Free.
       void PROXYCERTINFO_free (PROXYCERTINFO *cert_info)

   Duplicate
       PROXYCERTINFO * PROXYCERTINFO_dup (PROXYCERTINFO *cert_info)

   Compare
       int PROXYCERTINFO_cmp (const PROXYCERTINFO *a, const PROXYCERTINFO *b)

   Print to a BIO stream
       int PROXYCERTINFO_print (BIO *bp, PROXYCERTINFO *cert_info)

   Print To Stream
       int PROXYCERTINFO_print_fp (FILE *fp, PROXYCERTINFO *cert_info)

   Set the Policy Field
       int PROXYCERTINFO_set_policy (PROXYCERTINFO *cert_info, PROXYPOLICY *policy)

   Get the Policy Field
       PROXYPOLICY * PROXYCERTINFO_get_policy (PROXYCERTINFO *cert_info)

   Set the Path Length Field
       int PROXYCERTINFO_set_path_length (PROXYCERTINFO *cert_info, long path_length)

   Get Path Length Field
       long PROXYCERTINFO_get_path_length (PROXYCERTINFO *cert_info)

   Convert PROXYCERTINFO to DER encoded form
       int i2d_PROXYCERTINFO (PROXYCERTINFO *cert_info, unsigned char **pp)

   Convert a PROXYCERTINFO to internal form
       PROXYCERTINFO * d2i_PROXYCERTINFO (PROXYCERTINFO **cert_info, unsigned char **pp, long length)

   Convert old PROXYCERTINFO to DER encoded form
       int i2d_PROXYCERTINFO_OLD (PROXYCERTINFO *cert_info, unsigned char **pp)

   Convert a old PROXYCERTINFO to internal form
       PROXYCERTINFO * d2i_PROXYCERTINFO_OLD (PROXYCERTINFO **cert_info, unsigned char **pp, long length)

Detailed Description

       Author:
           Sam Meder

           Sam Lang

       The proxycertinfo.h file defines a method of maintaining information about proxy certificates.

Function Documentation

   ASN1_METHOD* PROXYCERTINFO_asn1_meth ()
       Define the functions required for manipulating a PROXYCERTINFO and its ASN1 form. Creates an ASN1_METHOD
       structure, which contains pointers to routines that convert any PROXYCERTINFO structure to its associated
       ASN1 DER encoded form and vice-versa.

       Returns:
           the ASN1_METHOD object

       References d2i_PROXYCERTINFO(), i2d_PROXYCERTINFO(), PROXYCERTINFO_free(), and PROXYCERTINFO_new().

   PROXYCERTINFO* PROXYCERTINFO_new ()
       Create a new PROXYCERTINFO. Allocates and initializes a new PROXYCERTINFO structure.

       Returns:
           pointer to the new PROXYCERTINFO

       References PROXYPOLICY_new().

   void PROXYCERTINFO_free (PROXYCERTINFO *cert_info)
       Free a PROXYCERTINFO.

       Parameters:
           cert_info pointer to the PROXYCERTINFO structure to be freed.

       References PROXYPOLICY_free().

   PROXYCERTINFO* PROXYCERTINFO_dup (PROXYCERTINFO *cert_info)
       Makes a copy of a PROXYCERTINFO. Makes a copy of a PROXYCERTINFO structure

       Parameters:
           cert_info the PROXYCERTINFO structure to copy

       Returns:
           the copied PROXYCERTINFO structure

       References d2i_PROXYCERTINFO(), and i2d_PROXYCERTINFO().

   int PROXYCERTINFO_cmp (const PROXYCERTINFO *a, const PROXYCERTINFO *b)
       Compares two PROXYCERTINFO structures.

       Parameters:
           a pointer to the first PROXYCERTINFO structure
           b pointer to the second PROXYCERTINFO structure

       Returns:
           an integer - the result of the comparison. The comparison compares each of the fields, so if any of
           those fields are not equal then a nonzero value is returned. Equality is indicated by returning a 0.

       References PROXYPOLICY_cmp().

   int PROXYCERTINFO_print (BIO *bp, PROXYCERTINFO *cert_info)
       print the PROXYCERTINFO structure to stdout

       Parameters:
           bp the BIO to print to
           cert_info the PROXYCERTINFO to print

       Returns:
           1 on success, 0 on error

   int PROXYCERTINFO_print_fp (FILE *fp, PROXYCERTINFO *cert_info)
       print the PROXYCERTINFO structure to the specified file stream

       Parameters:
           fp the file stream (FILE *) to print to
           cert_info the PROXYCERTINFO structure to print

       Returns:
           the number of characters printed

       References PROXYCERTINFO_print().

   int PROXYCERTINFO_set_policy (PROXYCERTINFO *cert_info, PROXYPOLICY *policy)
       Sets the policy on the PROXYCERTINFO Since this is an optional field in the ASN1 encoding, this variable
       can be set to NULL through this function - which means that when the PROXYCERTINFO is encoded the policy
       won't be included.

       Parameters:
           cert_info the PROXYCERTINFO object to set the policy of
           policy the PROXYPOLICY to set it to

       Returns:
           1 if success, 0 if error

       References PROXYPOLICY_dup(), and PROXYPOLICY_free().

   PROXYPOLICY* PROXYCERTINFO_get_policy (PROXYCERTINFO *cert_info)
       Gets the policy on the PROXYCERTINFO.

       Parameters:
           cert_info the PROXYCERTINFO to get the policy of

       Returns:
           the PROXYPOLICY of the PROXYCERTINFO

   int PROXYCERTINFO_set_path_length (PROXYCERTINFO *cert_info, longpath_length)
       Sets the path length of the PROXYCERTINFO. The path length specifices the maximum depth of the path of
       the Proxy Certificates that can be signed by an End Entity Certificate (EEC) or Proxy Certificate.

       Since this is an optional field in its ASN1 coded representation, it can be set to NULL through this
       function - which means that it won't be included in the encoding.

       Parameters:
           cert_info the PROXYCERTINFO to set the path length of
           path_length the path length to set it to if -1 is passed in, the path length gets unset, which
           configures the PROXYCERTINFO to not include the path length in the DER encoding

       Returns:
           1 on success, 0 on error

   long PROXYCERTINFO_get_path_length (PROXYCERTINFO *cert_info)
       Gets the path length of the PROXYCERTINFO.

       See Also:
           PROXYCERTINFO_set_path_length

       Parameters:
           cert_info the PROXYCERTINFO to get the path length from

       Returns:
           the path length of the PROXYCERTINFO, or -1 if not set

   int i2d_PROXYCERTINFO (PROXYCERTINFO *cert_info, unsigned char **pp)
       Converts the PROXYCERTINFO structure from internal format to a DER encoded ASN.1 string.

       Parameters:
           cert_info the PROXYCERTINFO structure to convert
           pp the resulting DER encoded string

       Returns:
           the length of the DER encoded string

       References i2d_PROXYPOLICY().

   PROXYCERTINFO* d2i_PROXYCERTINFO (PROXYCERTINFO **cert_info, unsigned char **pp, longlength)
       Convert from a DER encoded ASN.1 string of a PROXYCERTINFO to its internal structure.

       Parameters:
           cert_info the resulting PROXYCERTINFO in internal form
           pp the DER encoded ASN.1 string containing the PROXYCERTINFO
           length the length of the buffer

       Returns:
           the resulting PROXYCERTINFO in internal form

       References d2i_PROXYPOLICY(), PROXYCERTINFO_free(), and PROXYCERTINFO_new().

   int i2d_PROXYCERTINFO_OLD (PROXYCERTINFO *cert_info, unsigned char **pp)
       Converts the old PROXYCERTINFO structure from internal format to a DER encoded ASN.1 string.

       Parameters:
           cert_info the old PROXYCERTINFO structure to convert
           pp the resulting DER encoded string

       Returns:
           the length of the DER encoded string

       References i2d_PROXYPOLICY().

   PROXYCERTINFO* d2i_PROXYCERTINFO_OLD (PROXYCERTINFO **cert_info, unsigned char **pp, longlength)
       Convert from a DER encoded ASN.1 string of a old PROXYCERTINFO to its internal structure.

       Parameters:
           cert_info the resulting old PROXYCERTINFO in internal form
           pp the DER encoded ASN.1 string containing the old PROXYCERTINFO
           length the length of the buffer

       Returns:
           the resulting old PROXYCERTINFO in internal form

       References d2i_PROXYPOLICY(), and PROXYCERTINFO_new().

Author

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