]> git.ipfire.org Git - thirdparty/openssl.git/blob - apps/rand.c
Document command parameters.
[thirdparty/openssl.git] / apps / rand.c
1 /*
2 * Copyright 1998-2018 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 "apps.h"
11 #include "progs.h"
12
13 #include <ctype.h>
14 #include <stdio.h>
15 #include <string.h>
16
17 #include <openssl/bio.h>
18 #include <openssl/err.h>
19 #include <openssl/rand.h>
20
21 typedef enum OPTION_choice {
22 OPT_ERR = -1, OPT_EOF = 0, OPT_HELP,
23 OPT_OUT, OPT_ENGINE, OPT_BASE64, OPT_HEX,
24 OPT_R_ENUM
25 } OPTION_CHOICE;
26
27 const OPTIONS rand_options[] = {
28 {OPT_HELP_STR, 1, '-', "Usage: %s [options] num\n"},
29
30 OPT_SECTION("General"),
31 {"help", OPT_HELP, '-', "Display this summary"},
32 #ifndef OPENSSL_NO_ENGINE
33 {"engine", OPT_ENGINE, 's', "Use engine, possibly a hardware device"},
34 #endif
35
36 OPT_SECTION("Output"),
37 {"out", OPT_OUT, '>', "Output file"},
38 {"base64", OPT_BASE64, '-', "Base64 encode output"},
39 {"hex", OPT_HEX, '-', "Hex encode output"},
40
41 OPT_R_OPTIONS,
42
43 OPT_PARAMETERS(),
44 {"num", 0, 0, "Number of bytes to generate"},
45 {NULL}
46 };
47
48 int rand_main(int argc, char **argv)
49 {
50 ENGINE *e = NULL;
51 BIO *out = NULL;
52 char *outfile = NULL, *prog;
53 OPTION_CHOICE o;
54 int format = FORMAT_BINARY, i, num = -1, r, ret = 1;
55
56 prog = opt_init(argc, argv, rand_options);
57 while ((o = opt_next()) != OPT_EOF) {
58 switch (o) {
59 case OPT_EOF:
60 case OPT_ERR:
61 opthelp:
62 BIO_printf(bio_err, "%s: Use -help for summary.\n", prog);
63 goto end;
64 case OPT_HELP:
65 opt_help(rand_options);
66 ret = 0;
67 goto end;
68 case OPT_OUT:
69 outfile = opt_arg();
70 break;
71 case OPT_ENGINE:
72 e = setup_engine(opt_arg(), 0);
73 break;
74 case OPT_R_CASES:
75 if (!opt_rand(o))
76 goto end;
77 break;
78 case OPT_BASE64:
79 format = FORMAT_BASE64;
80 break;
81 case OPT_HEX:
82 format = FORMAT_TEXT;
83 break;
84 }
85 }
86 argc = opt_num_rest();
87 argv = opt_rest();
88 if (argc == 1) {
89 if (!opt_int(argv[0], &num) || num <= 0)
90 goto end;
91 } else if (argc > 0) {
92 BIO_printf(bio_err, "Extra arguments given.\n");
93 goto opthelp;
94 }
95
96 out = bio_open_default(outfile, 'w', format);
97 if (out == NULL)
98 goto end;
99
100 if (format == FORMAT_BASE64) {
101 BIO *b64 = BIO_new(BIO_f_base64());
102 if (b64 == NULL)
103 goto end;
104 out = BIO_push(b64, out);
105 }
106
107 while (num > 0) {
108 unsigned char buf[4096];
109 int chunk;
110
111 chunk = num;
112 if (chunk > (int)sizeof(buf))
113 chunk = sizeof(buf);
114 r = RAND_bytes(buf, chunk);
115 if (r <= 0)
116 goto end;
117 if (format != FORMAT_TEXT) {
118 if (BIO_write(out, buf, chunk) != chunk)
119 goto end;
120 } else {
121 for (i = 0; i < chunk; i++)
122 if (BIO_printf(out, "%02x", buf[i]) != 2)
123 goto end;
124 }
125 num -= chunk;
126 }
127 if (format == FORMAT_TEXT)
128 BIO_puts(out, "\n");
129 if (BIO_flush(out) <= 0)
130 goto end;
131
132 ret = 0;
133
134 end:
135 if (ret != 0)
136 ERR_print_errors(bio_err);
137 release_engine(e);
138 BIO_free_all(out);
139 return ret;
140 }