NAME    [Toc]    [Back]

       SSL_CTX_set_purpose  -  Set a purpose value to the SSL_CTX
       structure

SYNOPSIS    [Toc]    [Back]

       #include  <openssl/ssl.h>  #include  <openssl/x509v3.h>(to
       use the macros for purpose values)

       int SSL_CTX_set_purpose(
               SSL_CTX *s,
               int purpose );

DESCRIPTION    [Toc]    [Back]

       The SSL_CTX_set_purpose() function sets a purpose value in
       the SSL_CTX  structure.   The  purpose  values  and  their
       macros   are  defined  in  x509v3.h  as  follows:  #define
       X509_PURPOSE_SSL_CLIENT 1 #define  X509_PURPOSE_SSL_SERVER
       2  #define  X509_PURPOSE_NS_SSL_SERVER 3 #define X509_PURPOSE_SMIME_SIGN
  4  #define  X509_PURPOSE_SMIME_ENCRYPT  5
       #define X509_PURPOSE_CRL_SIGN 6 #define X509_PURPOSE_ANY 7

       The purpose value must be between 1 and 7. If  an  out-ofrange
  value is passed, the SSL_CTX_set_purpose() function
       returns 0. Upon success, 1 is returned.

RETURN VALUES    [Toc]    [Back]

       The following return values can occur: Seting the  purpose
       value  in  the  SSL_CTX structure was failed.  The purpose
       value was successfully set in the SSL_CTX structure.

SEE ALSO    [Toc]    [Back]

       Functions: SSL_set_purpose(3)



                                           SSL_CTX_set_purpose(3)