1 /* Compute MD5 or SHA1 checksum of files or strings
2 Copyright (C) 1995-2005 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2, or (at your option)
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software Foundation,
16 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
18 /* Written by Ulrich Drepper <drepper@gnu.ai.mit.edu>. */
23 #include <sys/types.h>
35 /* The official name of this program (e.g., no `g' prefix). */
36 #define PROGRAM_NAME (algorithm == ALG_MD5 ? "md5sum" : "sha1sum")
38 #define AUTHORS "Ulrich Drepper", "Scott Miller"
41 #define DIGEST_TYPE_STRING(Alg) ((Alg) == ALG_MD5 ? "MD5" : "SHA1")
42 #define DIGEST_STREAM(Alg) ((Alg) == ALG_MD5 ? md5_stream : sha1_stream)
44 #define DIGEST_BITS(Alg) ((Alg) == ALG_MD5 ? 128 : 160)
45 #define DIGEST_HEX_BYTES(Alg) (DIGEST_BITS (Alg) / 4)
46 #define DIGEST_BIN_BYTES(Alg) (DIGEST_BITS (Alg) / 8)
48 #define MAX_DIGEST_BIN_BYTES MAX (DIGEST_BIN_BYTES (ALG_MD5), \
49 DIGEST_BIN_BYTES (ALG_SHA1))
51 /* The minimum length of a valid digest line. This length does
52 not include any newline character at the end of a line. */
53 #define MIN_DIGEST_LINE_LENGTH(Alg) \
54 (DIGEST_HEX_BYTES (Alg) /* length of hexadecimal message digest */ \
55 + 2 /* blank and binary indicator */ \
56 + 1 /* minimum filename length */ )
58 /* True if any of the files read were the standard input. */
59 static bool have_read_stdin;
61 /* The minimum length of a valid checksum line for the selected algorithm. */
62 static size_t min_digest_line_length;
64 /* Set to the length of a digest hex string for the selected algorithm. */
65 static size_t digest_hex_bytes;
67 /* With --check, don't generate any output.
68 The exit code indicates success or failure. */
69 static bool status_only = false;
71 /* With --check, print a message to standard error warning about each
72 improperly formatted checksum line. */
73 static bool warn = false;
75 /* Declared and set via one of the wrapper .c files. */
76 /* int algorithm = ALG_UNSPECIFIED; */
78 /* The name this program was run with. */
81 /* For long options that have no equivalent short option, use a
82 non-character as a pseudo short option, starting with CHAR_MAX + 1. */
85 STATUS_OPTION = CHAR_MAX + 1
88 static const struct option long_options[] =
90 { "binary", no_argument, NULL, 'b' },
91 { "check", no_argument, NULL, 'c' },
92 { "status", no_argument, NULL, STATUS_OPTION },
93 { "text", no_argument, NULL, 't' },
94 { "warn", no_argument, NULL, 'w' },
95 { GETOPT_HELP_OPTION_DECL },
96 { GETOPT_VERSION_OPTION_DECL },
103 if (status != EXIT_SUCCESS)
104 fprintf (stderr, _("Try `%s --help' for more information.\n"),
109 Usage: %s [OPTION] [FILE]...\n\
110 Print or check %s (%d-bit) checksums.\n\
111 With no FILE, or when FILE is -, read standard input.\n\
115 DIGEST_TYPE_STRING (algorithm),
116 DIGEST_BITS (algorithm));
119 -b, --binary read in binary mode (default unless reading tty stdin)\n\
123 -b, --binary read in binary mode\n\
126 -c, --check read %s sums from the FILEs and check them\n"),
127 DIGEST_TYPE_STRING (algorithm));
130 -t, --text read in text mode (default if reading tty stdin)\n\
134 -t, --text read in text mode (default)\n\
138 The following two options are useful only when verifying checksums:\n\
139 --status don't output anything, status code shows success\n\
140 -w, --warn warn about improperly formatted checksum lines\n\
143 fputs (HELP_OPTION_DESCRIPTION, stdout);
144 fputs (VERSION_OPTION_DESCRIPTION, stdout);
147 The sums are computed as described in %s. When checking, the input\n\
148 should be a former output of this program. The default mode is to print\n\
149 a line with checksum, a character indicating type (`*' for binary, ` ' for\n\
150 text), and name for each FILE.\n"),
151 (algorithm == ALG_MD5 ? "RFC 1321" : "FIPS-180-1"));
152 printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
158 #define ISWHITE(c) ((c) == ' ' || (c) == '\t')
160 /* Split the checksum string S (of length S_LEN) from a BSD 'md5' or
161 'sha1' command into two parts: a hexadecimal digest, and the file
162 name. S is modified. Return true if successful. */
165 bsd_split_3 (char *s, size_t s_len, unsigned char **hex_digest, char **file_name)
171 /* Find end of filename. The BSD 'md5' and 'sha1' commands do not escape
172 filenames, so search backwards for the last ')'. */
174 while (i && s[i] != ')')
182 while (ISWHITE (s[i]))
190 while (ISWHITE (s[i]))
193 *hex_digest = (unsigned char *) &s[i];
197 /* Split the string S (of length S_LEN) into three parts:
198 a hexadecimal digest, binary flag, and the file name.
199 S is modified. Return true if successful. */
202 split_3 (char *s, size_t s_len,
203 unsigned char **hex_digest, int *binary, char **file_name)
206 bool escaped_filename = false;
207 size_t algo_name_len;
210 while (ISWHITE (s[i]))
213 /* Check for BSD-style checksum line. */
214 algo_name_len = strlen (DIGEST_TYPE_STRING (algorithm));
215 if (strncmp (s + i, DIGEST_TYPE_STRING (algorithm), algo_name_len) == 0)
217 if (strncmp (s + i + algo_name_len, " (", 2) == 0)
220 return bsd_split_3 (s + i + algo_name_len + 2,
221 s_len - (i + algo_name_len + 2),
222 hex_digest, file_name);
226 /* Ignore this line if it is too short.
227 Each line must have at least `min_digest_line_length - 1' (or one more, if
228 the first is a backslash) more characters to contain correct message digest
230 if (s_len - i < min_digest_line_length + (s[i] == '\\'))
236 escaped_filename = true;
238 *hex_digest = (unsigned char *) &s[i];
240 /* The first field has to be the n-character hexadecimal
241 representation of the message digest. If it is not followed
242 immediately by a white space it's an error. */
243 i += digest_hex_bytes;
249 if (s[i] != ' ' && s[i] != '*')
251 *binary = (s[i++] == '*');
253 /* All characters between the type indicator and end of line are
254 significant -- that includes leading and trailing white space. */
257 if (escaped_filename)
259 /* Translate each `\n' string in the file name to a NEWLINE,
260 and each `\\' string to a backslash. */
271 /* A valid line does not end with a backslash. */
284 /* Only `\' or `n' may follow a backslash. */
290 /* The file name may not contain a NUL. */
305 hex_digits (unsigned char const *s)
316 /* An interface to the function, DIGEST_STREAM,
317 (either md5_stream or sha1_stream).
318 Operate on FILENAME (it may be "-").
320 *BINARY indicates whether the file is binary. BINARY < 0 means it
321 depends on whether binary mode makes any difference and the file is
322 a terminal; in that case, clear *BINARY if the file was treated as
323 text because it was a terminal.
325 Put the checksum in *BIN_RESULT.
326 Return true if successful. */
329 digest_file (const char *filename, int *binary, unsigned char *bin_result,
330 int (*digest_stream) (FILE *, void *))
334 bool is_stdin = STREQ (filename, "-");
338 have_read_stdin = true;
340 if (O_BINARY && *binary)
343 *binary = ! isatty (STDIN_FILENO);
345 freopen (NULL, "rb", stdin);
350 fp = fopen (filename, (O_BINARY && *binary ? "rb" : "r"));
353 error (0, errno, "%s", filename);
358 err = (*digest_stream) (fp, bin_result);
361 error (0, errno, "%s", filename);
367 if (!is_stdin && fclose (fp) != 0)
369 error (0, errno, "%s", filename);
377 digest_check (const char *checkfile_name, int (*digest_stream) (FILE *, void *))
379 FILE *checkfile_stream;
380 uintmax_t n_properly_formatted_lines = 0;
381 uintmax_t n_mismatched_checksums = 0;
382 uintmax_t n_open_or_read_failures = 0;
383 unsigned char bin_buffer[MAX_DIGEST_BIN_BYTES];
384 uintmax_t line_number;
386 size_t line_chars_allocated;
387 bool is_stdin = STREQ (checkfile_name, "-");
391 have_read_stdin = true;
392 checkfile_name = _("standard input");
393 checkfile_stream = stdin;
397 checkfile_stream = fopen (checkfile_name, "r");
398 if (checkfile_stream == NULL)
400 error (0, errno, "%s", checkfile_name);
407 line_chars_allocated = 0;
412 unsigned char *hex_digest IF_LINT (= NULL);
416 if (line_number == 0)
417 error (EXIT_FAILURE, 0, _("%s: too many checksum lines"),
420 line_length = getline (&line, &line_chars_allocated, checkfile_stream);
421 if (line_length <= 0)
424 /* Ignore comment lines, which begin with a '#' character. */
428 /* Remove any trailing newline. */
429 if (line[line_length - 1] == '\n')
430 line[--line_length] = '\0';
432 if (! (split_3 (line, line_length, &hex_digest, &binary, &filename)
433 && ! (is_stdin && STREQ (filename, "-"))
434 && hex_digits (hex_digest)))
440 ": improperly formatted %s checksum line"),
441 checkfile_name, line_number,
442 DIGEST_TYPE_STRING (algorithm));
447 static const char bin2hex[] = { '0', '1', '2', '3',
450 'c', 'd', 'e', 'f' };
453 ++n_properly_formatted_lines;
455 ok = digest_file (filename, &binary, bin_buffer, digest_stream);
459 ++n_open_or_read_failures;
462 printf (_("%s: FAILED open or read\n"), filename);
468 size_t digest_bin_bytes = digest_hex_bytes / 2;
470 /* Compare generated binary number with text representation
471 in check file. Ignore case of hex digits. */
472 for (cnt = 0; cnt < digest_bin_bytes; ++cnt)
474 if (TOLOWER (hex_digest[2 * cnt])
475 != bin2hex[bin_buffer[cnt] >> 4]
476 || (TOLOWER (hex_digest[2 * cnt + 1])
477 != (bin2hex[bin_buffer[cnt] & 0xf])))
480 if (cnt != digest_bin_bytes)
481 ++n_mismatched_checksums;
485 printf ("%s: %s\n", filename,
486 (cnt != digest_bin_bytes ? _("FAILED") : _("OK")));
492 while (!feof (checkfile_stream) && !ferror (checkfile_stream));
496 if (ferror (checkfile_stream))
498 error (0, 0, _("%s: read error"), checkfile_name);
502 if (!is_stdin && fclose (checkfile_stream) != 0)
504 error (0, errno, "%s", checkfile_name);
508 if (n_properly_formatted_lines == 0)
510 /* Warn if no tests are found. */
511 error (0, 0, _("%s: no properly formatted %s checksum lines found"),
512 checkfile_name, DIGEST_TYPE_STRING (algorithm));
518 if (n_open_or_read_failures != 0)
520 ngettext ("WARNING: %" PRIuMAX " of %" PRIuMAX
521 " listed file could not be read",
522 "WARNING: %" PRIuMAX " of %" PRIuMAX
523 " listed files could not be read",
524 n_properly_formatted_lines),
525 n_open_or_read_failures, n_properly_formatted_lines);
527 if (n_mismatched_checksums != 0)
529 uintmax_t n_computed_checksums =
530 (n_properly_formatted_lines - n_open_or_read_failures);
532 ngettext ("WARNING: %" PRIuMAX " of %" PRIuMAX
533 " computed checksum did NOT match",
534 "WARNING: %" PRIuMAX " of %" PRIuMAX
535 " computed checksums did NOT match",
536 n_computed_checksums),
537 n_mismatched_checksums, n_computed_checksums);
542 return (n_properly_formatted_lines != 0
543 && n_mismatched_checksums == 0
544 && n_open_or_read_failures == 0);
548 main (int argc, char **argv)
550 unsigned char bin_buffer[MAX_DIGEST_BIN_BYTES];
551 bool do_check = false;
556 /* Setting values of global variables. */
557 initialize_main (&argc, &argv);
558 program_name = argv[0];
559 setlocale (LC_ALL, "");
560 bindtextdomain (PACKAGE, LOCALEDIR);
561 textdomain (PACKAGE);
563 atexit (close_stdout);
565 while ((opt = getopt_long (argc, argv, "bctw", long_options, NULL)) != -1)
585 case_GETOPT_HELP_CHAR;
586 case_GETOPT_VERSION_CHAR (PROGRAM_NAME, AUTHORS);
588 usage (EXIT_FAILURE);
591 min_digest_line_length = MIN_DIGEST_LINE_LENGTH (algorithm);
592 digest_hex_bytes = DIGEST_HEX_BYTES (algorithm);
594 if (0 <= binary && do_check)
596 error (0, 0, _("the --binary and --text options are meaningless when "
597 "verifying checksums"));
598 usage (EXIT_FAILURE);
601 if (status_only & !do_check)
604 _("the --status option is meaningful only when verifying checksums"));
605 usage (EXIT_FAILURE);
608 if (warn & !do_check)
611 _("the --warn option is meaningful only when verifying checksums"));
612 usage (EXIT_FAILURE);
618 for (; optind < argc; ++optind)
620 char *file = argv[optind];
623 ok &= digest_check (file, DIGEST_STREAM (algorithm));
626 int file_is_binary = binary;
628 if (! digest_file (file, &file_is_binary, bin_buffer,
629 DIGEST_STREAM (algorithm)))
635 /* Output a leading backslash if the file name contains
636 a newline or backslash. */
637 if (strchr (file, '\n') || strchr (file, '\\'))
640 for (i = 0; i < (digest_hex_bytes / 2); ++i)
641 printf ("%02x", bin_buffer[i]);
649 /* Translate each NEWLINE byte to the string, "\\n",
650 and each backslash to "\\\\". */
651 for (i = 0; i < strlen (file); ++i)
656 fputs ("\\n", stdout);
660 fputs ("\\\\", stdout);
673 if (have_read_stdin && fclose (stdin) == EOF)
674 error (EXIT_FAILURE, errno, _("standard input"));
676 exit (ok ? EXIT_SUCCESS : EXIT_FAILURE);