]>
git.ipfire.org Git - thirdparty/openssl.git/blob - apps/dgst.c
891cf79279b01b1b7ad08ede681327b7faddda0b
2 * Copyright 1995-2021 The OpenSSL Project Authors. All Rights Reserved.
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
15 #include <openssl/bio.h>
16 #include <openssl/err.h>
17 #include <openssl/evp.h>
18 #include <openssl/objects.h>
19 #include <openssl/x509.h>
20 #include <openssl/pem.h>
21 #include <openssl/hmac.h>
25 #define BUFSIZE 1024*8
27 int do_fp(BIO
*out
, unsigned char *buf
, BIO
*bp
, int sep
, int binout
, int xoflen
,
28 EVP_PKEY
*key
, unsigned char *sigin
, int siglen
,
29 const char *sig_name
, const char *md_name
,
31 static void show_digests(const OBJ_NAME
*name
, void *bio_
);
33 struct doall_dgst_digests
{
38 typedef enum OPTION_choice
{
39 OPT_ERR
= -1, OPT_EOF
= 0, OPT_HELP
, OPT_LIST
,
40 OPT_C
, OPT_R
, OPT_OUT
, OPT_SIGN
, OPT_PASSIN
, OPT_VERIFY
,
41 OPT_PRVERIFY
, OPT_SIGNATURE
, OPT_KEYFORM
, OPT_ENGINE
, OPT_ENGINE_IMPL
,
42 OPT_HEX
, OPT_BINARY
, OPT_DEBUG
, OPT_FIPS_FINGERPRINT
,
43 OPT_HMAC
, OPT_MAC
, OPT_SIGOPT
, OPT_MACOPT
, OPT_XOFLEN
,
45 OPT_R_ENUM
, OPT_PROV_ENUM
48 const OPTIONS dgst_options
[] = {
49 {OPT_HELP_STR
, 1, '-', "Usage: %s [options] [file...]\n"},
51 OPT_SECTION("General"),
52 {"help", OPT_HELP
, '-', "Display this summary"},
53 {"list", OPT_LIST
, '-', "List digests"},
54 #ifndef OPENSSL_NO_ENGINE
55 {"engine", OPT_ENGINE
, 's', "Use engine e, possibly a hardware device"},
56 {"engine_impl", OPT_ENGINE_IMPL
, '-',
57 "Also use engine given by -engine for digest operations"},
59 {"passin", OPT_PASSIN
, 's', "Input file pass phrase source"},
61 OPT_SECTION("Output"),
62 {"c", OPT_C
, '-', "Print the digest with separating colons"},
63 {"r", OPT_R
, '-', "Print the digest in coreutils format"},
64 {"out", OPT_OUT
, '>', "Output to filename rather than stdout"},
65 {"keyform", OPT_KEYFORM
, 'f', "Key file format (ENGINE, other values ignored)"},
66 {"hex", OPT_HEX
, '-', "Print as hex dump"},
67 {"binary", OPT_BINARY
, '-', "Print in binary form"},
68 {"xoflen", OPT_XOFLEN
, 'p', "Output length for XOF algorithms"},
69 {"d", OPT_DEBUG
, '-', "Print debug info"},
70 {"debug", OPT_DEBUG
, '-', "Print debug info"},
72 OPT_SECTION("Signing"),
73 {"sign", OPT_SIGN
, 's', "Sign digest using private key"},
74 {"verify", OPT_VERIFY
, 's', "Verify a signature using public key"},
75 {"prverify", OPT_PRVERIFY
, 's', "Verify a signature using private key"},
76 {"sigopt", OPT_SIGOPT
, 's', "Signature parameter in n:v form"},
77 {"signature", OPT_SIGNATURE
, '<', "File with signature to verify"},
78 {"hmac", OPT_HMAC
, 's', "Create hashed MAC with key"},
79 {"mac", OPT_MAC
, 's', "Create MAC (not necessarily HMAC)"},
80 {"macopt", OPT_MACOPT
, 's', "MAC algorithm parameters in n:v form or key"},
81 {"", OPT_DIGEST
, '-', "Any supported digest"},
82 {"fips-fingerprint", OPT_FIPS_FINGERPRINT
, '-',
83 "Compute HMAC with the key used in OpenSSL-FIPS fingerprint"},
89 {"file", 0, 0, "Files to digest (optional; default is stdin)"},
93 int dgst_main(int argc
, char **argv
)
95 BIO
*in
= NULL
, *inp
, *bmd
= NULL
, *out
= NULL
;
96 ENGINE
*e
= NULL
, *impl
= NULL
;
97 EVP_PKEY
*sigkey
= NULL
;
98 STACK_OF(OPENSSL_STRING
) *sigopts
= NULL
, *macopts
= NULL
;
99 char *hmac_key
= NULL
;
100 char *mac_name
= NULL
, *digestname
= NULL
;
101 char *passinarg
= NULL
, *passin
= NULL
;
102 const EVP_MD
*md
= NULL
;
103 const char *outfile
= NULL
, *keyfile
= NULL
, *prog
= NULL
;
104 const char *sigfile
= NULL
;
105 const char *md_name
= NULL
;
107 int separator
= 0, debug
= 0, keyform
= FORMAT_PEM
, siglen
= 0;
108 int i
, ret
= 1, out_bin
= -1, want_pub
= 0, do_verify
= 0;
110 unsigned char *buf
= NULL
, *sigbuf
= NULL
;
112 struct doall_dgst_digests dec
;
114 buf
= app_malloc(BUFSIZE
, "I/O buffer");
115 md
= EVP_get_digestbyname(argv
[0]);
117 prog
= opt_init(argc
, argv
, dgst_options
);
118 while ((o
= opt_next()) != OPT_EOF
) {
123 BIO_printf(bio_err
, "%s: Use -help for summary.\n", prog
);
126 opt_help(dgst_options
);
130 BIO_printf(bio_out
, "Supported digests:\n");
133 OBJ_NAME_do_all_sorted(OBJ_NAME_TYPE_MD_METH
,
135 BIO_printf(bio_out
, "\n");
155 passinarg
= opt_arg();
159 want_pub
= do_verify
= 1;
169 if (!opt_format(opt_arg(), OPT_FMT_ANY
, &keyform
))
173 e
= setup_engine(opt_arg(), 0);
175 case OPT_ENGINE_IMPL
:
185 xoflen
= atoi(opt_arg());
190 case OPT_FIPS_FINGERPRINT
:
191 hmac_key
= "etaonrishdlcupfm";
194 hmac_key
= opt_arg();
197 mac_name
= opt_arg();
201 sigopts
= sk_OPENSSL_STRING_new_null();
202 if (!sigopts
|| !sk_OPENSSL_STRING_push(sigopts
, opt_arg()))
207 macopts
= sk_OPENSSL_STRING_new_null();
208 if (!macopts
|| !sk_OPENSSL_STRING_push(macopts
, opt_arg()))
212 digestname
= opt_unknown();
215 if (!opt_provider(o
))
221 /* Remaining args are files to digest. */
222 argc
= opt_num_rest();
224 if (keyfile
!= NULL
&& argc
> 1) {
225 BIO_printf(bio_err
, "%s: Can only sign or verify one file.\n", prog
);
229 if (digestname
!= NULL
) {
230 if (!opt_md(digestname
, &md
))
234 if (do_verify
&& sigfile
== NULL
) {
236 "No signature to verify: use the -signature option\n");
242 in
= BIO_new(BIO_s_file());
243 bmd
= BIO_new(BIO_f_md());
244 if ((in
== NULL
) || (bmd
== NULL
)) {
245 ERR_print_errors(bio_err
);
250 BIO_set_callback(in
, BIO_debug_callback
);
251 /* needed for windows 3.1 */
252 BIO_set_callback_arg(in
, (char *)bio_err
);
255 if (!app_passwd(passinarg
, NULL
, &passin
, NULL
)) {
256 BIO_printf(bio_err
, "Error getting password\n");
267 out
= bio_open_default(outfile
, 'w', out_bin
? FORMAT_BINARY
: FORMAT_TEXT
);
271 if ((!(mac_name
== NULL
) + !(keyfile
== NULL
) + !(hmac_key
== NULL
)) > 1) {
272 BIO_printf(bio_err
, "MAC and Signing key cannot both be specified\n");
276 if (keyfile
!= NULL
) {
280 sigkey
= load_pubkey(keyfile
, keyform
, 0, NULL
, e
, "public key");
282 sigkey
= load_key(keyfile
, keyform
, 0, passin
, e
, "private key");
283 if (sigkey
== NULL
) {
285 * load_[pub]key() has already printed an appropriate message
289 type
= EVP_PKEY_id(sigkey
);
290 if (type
== EVP_PKEY_ED25519
|| type
== EVP_PKEY_ED448
) {
292 * We implement PureEdDSA for these which doesn't have a separate
293 * digest, and only supports one shot.
295 BIO_printf(bio_err
, "Key type not supported for this operation\n");
300 if (mac_name
!= NULL
) {
301 EVP_PKEY_CTX
*mac_ctx
= NULL
;
303 if (!init_gen_str(&mac_ctx
, mac_name
, impl
, 0, NULL
, NULL
))
305 if (macopts
!= NULL
) {
307 for (i
= 0; i
< sk_OPENSSL_STRING_num(macopts
); i
++) {
308 macopt
= sk_OPENSSL_STRING_value(macopts
, i
);
309 if (pkey_ctrl_string(mac_ctx
, macopt
) <= 0) {
311 "MAC parameter error \"%s\"\n", macopt
);
312 ERR_print_errors(bio_err
);
317 if (EVP_PKEY_keygen(mac_ctx
, &sigkey
) <= 0) {
318 BIO_puts(bio_err
, "Error generating key\n");
319 ERR_print_errors(bio_err
);
324 EVP_PKEY_CTX_free(mac_ctx
);
329 if (hmac_key
!= NULL
) {
330 sigkey
= EVP_PKEY_new_raw_private_key(EVP_PKEY_HMAC
, impl
,
331 (unsigned char *)hmac_key
,
337 if (sigkey
!= NULL
) {
338 EVP_MD_CTX
*mctx
= NULL
;
339 EVP_PKEY_CTX
*pctx
= NULL
;
341 if (!BIO_get_md_ctx(bmd
, &mctx
)) {
342 BIO_printf(bio_err
, "Error getting context\n");
343 ERR_print_errors(bio_err
);
347 r
= EVP_DigestVerifyInit(mctx
, &pctx
, md
, impl
, sigkey
);
349 r
= EVP_DigestSignInit(mctx
, &pctx
, md
, impl
, sigkey
);
351 BIO_printf(bio_err
, "Error setting context\n");
352 ERR_print_errors(bio_err
);
355 if (sigopts
!= NULL
) {
357 for (i
= 0; i
< sk_OPENSSL_STRING_num(sigopts
); i
++) {
358 sigopt
= sk_OPENSSL_STRING_value(sigopts
, i
);
359 if (pkey_ctrl_string(pctx
, sigopt
) <= 0) {
360 BIO_printf(bio_err
, "parameter error \"%s\"\n", sigopt
);
361 ERR_print_errors(bio_err
);
367 /* we use md as a filter, reading from 'in' */
369 EVP_MD_CTX
*mctx
= NULL
;
370 if (!BIO_get_md_ctx(bmd
, &mctx
)) {
371 BIO_printf(bio_err
, "Error getting context\n");
372 ERR_print_errors(bio_err
);
377 if (!EVP_DigestInit_ex(mctx
, md
, impl
)) {
378 BIO_printf(bio_err
, "Error setting digest\n");
379 ERR_print_errors(bio_err
);
384 if (sigfile
!= NULL
&& sigkey
!= NULL
) {
385 BIO
*sigbio
= BIO_new_file(sigfile
, "rb");
386 if (sigbio
== NULL
) {
387 BIO_printf(bio_err
, "Error opening signature file %s\n", sigfile
);
388 ERR_print_errors(bio_err
);
391 siglen
= EVP_PKEY_size(sigkey
);
392 sigbuf
= app_malloc(siglen
, "signature buffer");
393 siglen
= BIO_read(sigbio
, sigbuf
, siglen
);
396 BIO_printf(bio_err
, "Error reading signature file %s\n", sigfile
);
397 ERR_print_errors(bio_err
);
401 inp
= BIO_push(bmd
, in
);
405 BIO_get_md_ctx(bmd
, &tctx
);
406 md
= EVP_MD_CTX_md(tctx
);
409 md_name
= EVP_MD_name(md
);
412 if (!(EVP_MD_flags(md
) & EVP_MD_FLAG_XOF
)) {
413 BIO_printf(bio_err
, "Length can only be specified for XOF\n");
416 if (sigkey
!= NULL
) {
417 BIO_printf(bio_err
, "Signing key cannot be specified for XOF\n");
423 BIO_set_fp(in
, stdin
, BIO_NOCLOSE
);
424 ret
= do_fp(out
, buf
, inp
, separator
, out_bin
, xoflen
, sigkey
, sigbuf
,
425 siglen
, NULL
, md_name
, "stdin");
427 const char *sig_name
= NULL
;
430 sig_name
= EVP_PKEY_get0_first_alg_name(sigkey
);
433 for (i
= 0; i
< argc
; i
++) {
435 if (BIO_read_filename(in
, argv
[i
]) <= 0) {
440 r
= do_fp(out
, buf
, inp
, separator
, out_bin
, xoflen
,
441 sigkey
, sigbuf
, siglen
, sig_name
, md_name
, argv
[i
]);
445 (void)BIO_reset(bmd
);
449 OPENSSL_clear_free(buf
, BUFSIZE
);
451 OPENSSL_free(passin
);
453 EVP_PKEY_free(sigkey
);
454 sk_OPENSSL_STRING_free(sigopts
);
455 sk_OPENSSL_STRING_free(macopts
);
456 OPENSSL_free(sigbuf
);
462 static void show_digests(const OBJ_NAME
*name
, void *arg
)
464 struct doall_dgst_digests
*dec
= (struct doall_dgst_digests
*)arg
;
465 const EVP_MD
*md
= NULL
;
467 /* Filter out signed digests (a.k.a signature algorithms) */
468 if (strstr(name
->name
, "rsa") != NULL
|| strstr(name
->name
, "RSA") != NULL
)
471 if (!islower((unsigned char)*name
->name
))
474 /* Filter out message digests that we cannot use */
475 md
= EVP_get_digestbyname(name
->name
);
479 BIO_printf(dec
->bio
, "-%-25s", name
->name
);
481 BIO_printf(dec
->bio
, "\n");
484 BIO_printf(dec
->bio
, " ");
489 * The newline_escape_filename function performs newline escaping for any
490 * filename that contains a newline. This function also takes a pointer
491 * to backslash. The backslash pointer is a flag to indicating whether a newline
492 * is present in the filename. If a newline is present, the backslash flag is
493 * set and the output format will contain a backslash at the beginning of the
494 * digest output. This output format is to replicate the output format found
495 * in the '*sum' checksum programs. This aims to preserve backward
498 static const char *newline_escape_filename(const char *file
, int * backslash
)
500 size_t i
, e
= 0, length
= strlen(file
), newline_count
= 0, mem_len
= 0;
501 char *file_cpy
= NULL
;
503 for (i
= 0; i
< length
; i
++)
507 mem_len
= length
+ newline_count
+ 1;
508 file_cpy
= app_malloc(mem_len
, file
);
512 const char c
= file
[e
];
514 file_cpy
[i
++] = '\\';
523 return (const char*)file_cpy
;
527 int do_fp(BIO
*out
, unsigned char *buf
, BIO
*bp
, int sep
, int binout
, int xoflen
,
528 EVP_PKEY
*key
, unsigned char *sigin
, int siglen
,
529 const char *sig_name
, const char *md_name
,
532 size_t len
= BUFSIZE
;
533 int i
, backslash
= 0, ret
= 1;
534 unsigned char *allocated_buf
= NULL
;
536 while (BIO_pending(bp
) || !BIO_eof(bp
)) {
537 i
= BIO_read(bp
, (char *)buf
, BUFSIZE
);
539 BIO_printf(bio_err
, "Read Error in %s\n", file
);
540 ERR_print_errors(bio_err
);
548 BIO_get_md_ctx(bp
, &ctx
);
549 i
= EVP_DigestVerifyFinal(ctx
, sigin
, (unsigned int)siglen
);
551 BIO_printf(out
, "Verified OK\n");
553 BIO_printf(out
, "Verification Failure\n");
556 BIO_printf(bio_err
, "Error Verifying Data\n");
557 ERR_print_errors(bio_err
);
567 BIO_get_md_ctx(bp
, &ctx
);
568 if (!EVP_DigestSignFinal(ctx
, NULL
, &tmplen
)) {
569 BIO_printf(bio_err
, "Error Signing Data\n");
570 ERR_print_errors(bio_err
);
573 if (tmplen
> BUFSIZE
) {
575 allocated_buf
= app_malloc(len
, "Signature buffer");
578 if (!EVP_DigestSignFinal(ctx
, buf
, &len
)) {
579 BIO_printf(bio_err
, "Error Signing Data\n");
580 ERR_print_errors(bio_err
);
583 } else if (xoflen
> 0) {
588 allocated_buf
= app_malloc(len
, "Digest buffer");
592 BIO_get_md_ctx(bp
, &ctx
);
594 if (!EVP_DigestFinalXOF(ctx
, buf
, len
)) {
595 BIO_printf(bio_err
, "Error Digesting Data\n");
596 ERR_print_errors(bio_err
);
600 len
= BIO_gets(bp
, (char *)buf
, BUFSIZE
);
602 ERR_print_errors(bio_err
);
608 BIO_write(out
, buf
, len
);
609 } else if (sep
== 2) {
610 file
= newline_escape_filename(file
, &backslash
);
615 for (i
= 0; i
< (int)len
; i
++)
616 BIO_printf(out
, "%02x", buf
[i
]);
618 BIO_printf(out
, " *%s\n", file
);
619 OPENSSL_free((char *)file
);
621 if (sig_name
!= NULL
) {
622 BIO_puts(out
, sig_name
);
624 BIO_printf(out
, "-%s", md_name
);
625 BIO_printf(out
, "(%s)= ", file
);
626 } else if (md_name
!= NULL
) {
627 BIO_printf(out
, "%s(%s)= ", md_name
, file
);
629 BIO_printf(out
, "(%s)= ", file
);
631 for (i
= 0; i
< (int)len
; i
++) {
633 BIO_printf(out
, ":");
634 BIO_printf(out
, "%02x", buf
[i
]);
636 BIO_printf(out
, "\n");
641 if (allocated_buf
!= NULL
)
642 OPENSSL_clear_free(allocated_buf
, len
);