Deprecate old style BIO callback calls
[openssl.git] / apps / include / s_apps.h
1 /*
2  * Copyright 1995-2021 The OpenSSL Project Authors. All Rights Reserved.
3  *
4  * Licensed under the Apache License 2.0 (the "License").  You may not use
5  * this file except in compliance with the License.  You can obtain a copy
6  * in the file LICENSE in the source distribution or at
7  * https://www.openssl.org/source/license.html
8  */
9
10 #include <openssl/opensslconf.h>
11
12 #include <openssl/ssl.h>
13 #include <openssl/srp.h>
14
15 #define PORT            "4433"
16 #define PROTOCOL        "tcp"
17
18 typedef int (*do_server_cb)(int s, int stype, int prot, unsigned char *context);
19 int report_server_accept(BIO *out, int asock, int with_address);
20 int do_server(int *accept_sock, const char *host, const char *port,
21               int family, int type, int protocol, do_server_cb cb,
22               unsigned char *context, int naccept, BIO *bio_s_out);
23
24 int verify_callback(int ok, X509_STORE_CTX *ctx);
25
26 int set_cert_stuff(SSL_CTX *ctx, char *cert_file, char *key_file);
27 int set_cert_key_stuff(SSL_CTX *ctx, X509 *cert, EVP_PKEY *key,
28                        STACK_OF(X509) *chain, int build_chain);
29 int ssl_print_sigalgs(BIO *out, SSL *s);
30 int ssl_print_point_formats(BIO *out, SSL *s);
31 int ssl_print_groups(BIO *out, SSL *s, int noshared);
32 int ssl_print_tmp_key(BIO *out, SSL *s);
33 int init_client(int *sock, const char *host, const char *port,
34                 const char *bindhost, const char *bindport,
35                 int family, int type, int protocol);
36 int should_retry(int i);
37 void do_ssl_shutdown(SSL *ssl);
38
39 long bio_dump_callback(BIO *bio, int cmd, const char *argp, size_t len,
40                        int argi, long argl, int ret, size_t *processed);
41
42 void apps_ssl_info_callback(const SSL *s, int where, int ret);
43 void msg_cb(int write_p, int version, int content_type, const void *buf,
44             size_t len, SSL *ssl, void *arg);
45 void tlsext_cb(SSL *s, int client_server, int type, const unsigned char *data,
46                int len, void *arg);
47
48 int generate_cookie_callback(SSL *ssl, unsigned char *cookie,
49                              unsigned int *cookie_len);
50 int verify_cookie_callback(SSL *ssl, const unsigned char *cookie,
51                            unsigned int cookie_len);
52
53 #ifdef __VMS                     /* 31 char symbol name limit */
54 # define generate_stateless_cookie_callback      generate_stateless_cookie_cb
55 # define verify_stateless_cookie_callback        verify_stateless_cookie_cb
56 #endif
57
58 int generate_stateless_cookie_callback(SSL *ssl, unsigned char *cookie,
59                                        size_t *cookie_len);
60 int verify_stateless_cookie_callback(SSL *ssl, const unsigned char *cookie,
61                                      size_t cookie_len);
62
63 typedef struct ssl_excert_st SSL_EXCERT;
64
65 void ssl_ctx_set_excert(SSL_CTX *ctx, SSL_EXCERT *exc);
66 void ssl_excert_free(SSL_EXCERT *exc);
67 int args_excert(int option, SSL_EXCERT **pexc);
68 int load_excert(SSL_EXCERT **pexc);
69 void print_verify_detail(SSL *s, BIO *bio);
70 void print_ssl_summary(SSL *s);
71 int config_ctx(SSL_CONF_CTX *cctx, STACK_OF(OPENSSL_STRING) *str, SSL_CTX *ctx);
72 int ssl_ctx_add_crls(SSL_CTX *ctx, STACK_OF(X509_CRL) *crls,
73                      int crl_download);
74 int ssl_load_stores(SSL_CTX *ctx, const char *vfyCApath,
75                     const char *vfyCAfile, const char *vfyCAstore,
76                     const char *chCApath, const char *chCAfile,
77                     const char *chCAstore, STACK_OF(X509_CRL) *crls,
78                     int crl_download);
79 void ssl_ctx_security_debug(SSL_CTX *ctx, int verbose);
80 int set_keylog_file(SSL_CTX *ctx, const char *keylog_file);
81 void print_ca_names(BIO *bio, SSL *s);
82
83 #ifndef OPENSSL_NO_SRP
84 /* The client side SRP context that we pass to all SRP related callbacks */
85 typedef struct srp_arg_st {
86     char *srppassin;
87     char *srplogin;
88     int msg;                    /* copy from c_msg */
89     int debug;                  /* copy from c_debug */
90     int amp;                    /* allow more groups */
91     int strength;               /* minimal size for N */
92 } SRP_ARG;
93
94 int set_up_srp_arg(SSL_CTX *ctx, SRP_ARG *srp_arg, int srp_lateuser, int c_msg,
95                    int c_debug);
96 void set_up_dummy_srp(SSL_CTX *ctx);
97
98 /* The server side SRP context that we pass to all SRP related callbacks */
99 typedef struct srpsrvparm_st {
100     char *login;
101     SRP_VBASE *vb;
102     SRP_user_pwd *user;
103 } srpsrvparm;
104
105 int set_up_srp_verifier_file(SSL_CTX *ctx, srpsrvparm *srp_callback_parm,
106                              char *srpuserseed, char *srp_verifier_file);
107 void lookup_srp_user(srpsrvparm *srp_callback_parm, BIO *bio_s_out);
108 #endif /* OPENSSL_NO_SRP */