Add TLS_FALLBACK_SCSV documentation, and move s_client -fallback_scsv
[openssl.git] / apps / ciphers.c
1 /* apps/ciphers.c */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  * 
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  * 
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  * 
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *    notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *    notice, this list of conditions and the following disclaimer in the
30  *    documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *    must display the following acknowledgement:
33  *    "This product includes cryptographic software written by
34  *     Eric Young (eay@cryptsoft.com)"
35  *    The word 'cryptographic' can be left out if the rouines from the library
36  *    being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from 
38  *    the apps directory (application code) you must include an acknowledgement:
39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  * 
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  * 
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58
59 #include <stdio.h>
60 #include <stdlib.h>
61 #include <string.h>
62 #ifdef OPENSSL_NO_STDIO
63 #define APPS_WIN16
64 #endif
65 #include "apps.h"
66 #include <openssl/err.h>
67 #include <openssl/ssl.h>
68
69 #undef PROG
70 #define PROG    ciphers_main
71
72 static const char *ciphers_usage[]={
73 "usage: ciphers args\n",
74 " -v          - verbose mode, a textual listing of the SSL/TLS ciphers in OpenSSL\n",
75 " -V          - even more verbose\n",
76 " -ssl2       - SSL2 mode\n",
77 " -ssl3       - SSL3 mode\n",
78 " -tls1       - TLS1 mode\n",
79 NULL
80 };
81
82 int MAIN(int, char **);
83
84 int MAIN(int argc, char **argv)
85         {
86         int ret=1,i;
87         int verbose=0,Verbose=0;
88         int use_supported = 0;
89 #ifndef OPENSSL_NO_SSL_TRACE
90         int stdname = 0;
91 #endif
92         const char **pp;
93         const char *p;
94         int badops=0;
95         SSL_CTX *ctx=NULL;
96         SSL *ssl=NULL;
97         char *ciphers=NULL;
98         const SSL_METHOD *meth=NULL;
99         STACK_OF(SSL_CIPHER) *sk=NULL;
100         char buf[512];
101         BIO *STDout=NULL;
102
103         meth=SSLv23_server_method();
104
105         apps_startup();
106
107         if (bio_err == NULL)
108                 bio_err=BIO_new_fp(stderr,BIO_NOCLOSE);
109         STDout=BIO_new_fp(stdout,BIO_NOCLOSE);
110 #ifdef OPENSSL_SYS_VMS
111         {
112         BIO *tmpbio = BIO_new(BIO_f_linebuffer());
113         STDout = BIO_push(tmpbio, STDout);
114         }
115 #endif
116         if (!load_config(bio_err, NULL))
117                 goto end;
118
119         argc--;
120         argv++;
121         while (argc >= 1)
122                 {
123                 if (strcmp(*argv,"-v") == 0)
124                         verbose=1;
125                 else if (strcmp(*argv,"-V") == 0)
126                         verbose=Verbose=1;
127                 else if (strcmp(*argv,"-s") == 0)
128                         use_supported = 1;
129 #ifndef OPENSSL_NO_SSL_TRACE
130                 else if (strcmp(*argv,"-stdname") == 0)
131                         stdname=verbose=1;
132 #endif
133 #ifndef OPENSSL_NO_SSL2
134                 else if (strcmp(*argv,"-ssl2") == 0)
135                         meth=SSLv2_client_method();
136 #endif
137 #ifndef OPENSSL_NO_SSL3
138                 else if (strcmp(*argv,"-ssl3") == 0)
139                         meth=SSLv3_client_method();
140 #endif
141 #ifndef OPENSSL_NO_TLS1
142                 else if (strcmp(*argv,"-tls1") == 0)
143                         meth=TLSv1_client_method();
144 #endif
145                 else if ((strncmp(*argv,"-h",2) == 0) ||
146                          (strcmp(*argv,"-?") == 0))
147                         {
148                         badops=1;
149                         break;
150                         }
151                 else
152                         {
153                         ciphers= *argv;
154                         }
155                 argc--;
156                 argv++;
157                 }
158
159         if (badops)
160                 {
161                 for (pp=ciphers_usage; (*pp != NULL); pp++)
162                         BIO_printf(bio_err,"%s",*pp);
163                 goto end;
164                 }
165
166         OpenSSL_add_ssl_algorithms();
167
168         ctx=SSL_CTX_new(meth);
169         if (ctx == NULL) goto err;
170         if (ciphers != NULL) {
171                 if(!SSL_CTX_set_cipher_list(ctx,ciphers)) {
172                         BIO_printf(bio_err, "Error in cipher list\n");
173                         goto err;
174                 }
175         }
176         ssl=SSL_new(ctx);
177         if (ssl == NULL) goto err;
178
179         if (use_supported)
180                 sk=SSL_get1_supported_ciphers(ssl);
181         else
182                 sk=SSL_get_ciphers(ssl);
183
184         if (!verbose)
185                 {
186                 for (i=0; i<sk_SSL_CIPHER_num(sk); i++)
187                         {
188                         SSL_CIPHER *c = sk_SSL_CIPHER_value(sk,i);
189                         p = SSL_CIPHER_get_name(c);
190                         if (p == NULL) break;
191                         if (i != 0) BIO_printf(STDout,":");
192                         BIO_printf(STDout,"%s",p);
193                         }
194                 BIO_printf(STDout,"\n");
195                 }
196         else /* verbose */
197                 {
198
199                 for (i=0; i<sk_SSL_CIPHER_num(sk); i++)
200                         {
201                         SSL_CIPHER *c;
202
203                         c = sk_SSL_CIPHER_value(sk,i);
204                         
205                         if (Verbose)
206                                 {
207                                 unsigned long id = SSL_CIPHER_get_id(c);
208                                 int id0 = (int)(id >> 24);
209                                 int id1 = (int)((id >> 16) & 0xffL);
210                                 int id2 = (int)((id >> 8) & 0xffL);
211                                 int id3 = (int)(id & 0xffL);
212                                 
213                                 if ((id & 0xff000000L) == 0x02000000L)
214                                         BIO_printf(STDout, "     0x%02X,0x%02X,0x%02X - ", id1, id2, id3); /* SSL2 cipher */
215                                 else if ((id & 0xff000000L) == 0x03000000L)
216                                         BIO_printf(STDout, "          0x%02X,0x%02X - ", id2, id3); /* SSL3 cipher */
217                                 else
218                                         BIO_printf(STDout, "0x%02X,0x%02X,0x%02X,0x%02X - ", id0, id1, id2, id3); /* whatever */
219                                 }
220 #ifndef OPENSSL_NO_SSL_TRACE
221                         if (stdname)
222                                 {
223                                 const char *nm = SSL_CIPHER_standard_name(c);
224                                 if (nm == NULL)
225                                         nm = "UNKNOWN";
226                                 BIO_printf(STDout, "%s - ", nm);
227                                 }
228 #endif
229                         BIO_puts(STDout,SSL_CIPHER_description(c,buf,sizeof buf));
230                         }
231                 }
232
233         ret=0;
234         if (0)
235                 {
236 err:
237                 SSL_load_error_strings();
238                 ERR_print_errors(bio_err);
239                 }
240 end:
241         if (use_supported && sk)
242                 sk_SSL_CIPHER_free(sk);
243         if (ctx != NULL) SSL_CTX_free(ctx);
244         if (ssl != NULL) SSL_free(ssl);
245         if (STDout != NULL) BIO_free_all(STDout);
246         apps_shutdown();
247         OPENSSL_EXIT(ret);
248         }
249