1 /* Compute MD5 or SHA1 checksum of files or strings
2 Copyright (C) 1995-2002 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
18 /* Written by Ulrich Drepper <drepper@gnu.ai.mit.edu>. */
24 #include <sys/types.h>
35 /* The official name of this program (e.g., no `g' prefix). */
36 #define PROGRAM_NAME (algorithm == ALG_MD5 ? "md5sum" : "shasum")
38 #define AUTHORS N_ ("Ulrich Drepper and Scott Miller")
40 /* Most systems do not distinguish between external and internal
41 text representations. */
42 /* FIXME: This begs for an autoconf test. */
44 # define OPENOPTS(BINARY) ((BINARY) != 0 ? TEXT1TO1 : TEXTCNVT)
45 # define TEXT1TO1 "rb"
49 # define OPENOPTS(BINARY) ((BINARY) != 0 ? TEXT1TO1 : TEXTCNVT)
50 # define TEXT1TO1 "rb", "ctx=stm"
51 # define TEXTCNVT "r", "ctx=stm"
53 # if UNIX || __UNIX__ || unix || __unix__ || _POSIX_VERSION
54 # define OPENOPTS(BINARY) "r"
56 /* The following line is intended to evoke an error.
57 Using #error is not portable enough. */
58 "Cannot determine system type."
64 #define DIGEST_TYPE_STRING(Alg) ((Alg) == ALG_MD5 ? "MD5" : "SHA1")
65 #define DIGEST_STREAM(Alg) ((Alg) == ALG_MD5 ? md5_stream : sha_stream)
67 #define DIGEST_BITS(Alg) ((Alg) == ALG_MD5 ? 128 : 160)
68 #define DIGEST_HEX_BYTES(Alg) (DIGEST_BITS (Alg) / 4)
69 #define DIGEST_BIN_BYTES(Alg) (DIGEST_BITS (Alg) / 8)
71 #define MAX_DIGEST_BIN_BYTES MAX (DIGEST_BIN_BYTES (ALG_MD5), \
72 DIGEST_BIN_BYTES (ALG_SHA1))
74 /* The minimum length of a valid digest line. This length does
75 not include any newline character at the end of a line. */
76 #define MIN_DIGEST_LINE_LENGTH(Alg) \
77 (DIGEST_HEX_BYTES (Alg) /* length of hexadecimal message digest */ \
78 + 2 /* blank and binary indicator */ \
79 + 1 /* minimum filename length */ )
81 /* Nonzero if any of the files read were the standard input. */
82 static int have_read_stdin
;
84 /* The minimum length of a valid checksum line for the selected algorithm. */
85 static size_t min_digest_line_length
;
87 /* Set to the length of a digest hex string for the selected algorithm. */
88 static size_t digest_hex_bytes
;
90 /* With --check, don't generate any output.
91 The exit code indicates success or failure. */
92 static int status_only
= 0;
94 /* With --check, print a message to standard error warning about each
95 improperly formatted checksum line. */
98 /* Declared and set via one of the wrapper .c files. */
99 /* int algorithm = ALG_UNSPECIFIED; */
101 /* The name this program was run with. */
104 static const struct option long_options
[] =
106 { "binary", no_argument
, 0, 'b' },
107 { "check", no_argument
, 0, 'c' },
108 { "status", no_argument
, 0, 2 },
109 { "string", required_argument
, 0, 1 },
110 { "text", no_argument
, 0, 't' },
111 { "warn", no_argument
, 0, 'w' },
112 { GETOPT_HELP_OPTION_DECL
},
113 { GETOPT_VERSION_OPTION_DECL
},
121 fprintf (stderr
, _("Try `%s --help' for more information.\n"),
126 Usage: %s [OPTION] [FILE]...\n\
127 or: %s [OPTION] --check [FILE]\n\
128 Print or check %s (%d-bit) checksums.\n\
129 With no FILE, or when FILE is -, read standard input.\n\
131 program_name
, program_name
,
132 DIGEST_TYPE_STRING (algorithm
),
133 DIGEST_BITS (algorithm
));
136 -b, --binary read files in binary mode (default on DOS/Windows)\n\
137 -c, --check check %s sums against given list\n\
138 -t, --text read files in text mode (default)\n\
141 DIGEST_TYPE_STRING (algorithm
));
143 The following two options are useful only when verifying checksums:\n\
144 --status don't output anything, status code shows success\n\
145 -w, --warn warn about improperly formated checksum lines\n\
148 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
149 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
152 The sums are computed as described in %s. When checking, the input\n\
153 should be a former output of this program. The default mode is to print\n\
154 a line with checksum, a character indicating type (`*' for binary, ` ' for\n\
155 text), and name for each FILE.\n"),
156 (algorithm
== ALG_MD5
? "RFC 1321" : "FIPS-180-1"));
157 printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT
);
160 exit (status
== 0 ? EXIT_SUCCESS
: EXIT_FAILURE
);
163 /* Split the string S (of length S_LEN) into three parts:
164 a hexadecimal digest, binary flag, and the file name.
168 split_3 (char *s
, size_t s_len
,
169 unsigned char **hex_digest
, int *binary
, char **file_name
)
172 int escaped_filename
= 0;
174 #define ISWHITE(c) ((c) == ' ' || (c) == '\t')
177 while (ISWHITE (s
[i
]))
180 /* Ignore this line if it is too short.
181 Each line must have at least `min_digest_line_length - 1' (or one more, if
182 the first is a backslash) more characters to contain correct message digest
184 if (s_len
- i
< min_digest_line_length
+ (s
[i
] == '\\'))
190 escaped_filename
= 1;
192 *hex_digest
= (unsigned char *) &s
[i
];
194 /* The first field has to be the n-character hexadecimal
195 representation of the message digest. If it is not followed
196 immediately by a white space it's an error. */
197 i
+= digest_hex_bytes
;
203 if (s
[i
] != ' ' && s
[i
] != '*')
205 *binary
= (s
[i
++] == '*');
207 /* All characters between the type indicator and end of line are
208 significant -- that includes leading and trailing white space. */
211 if (escaped_filename
)
213 /* Translate each `\n' string in the file name to a NEWLINE,
214 and each `\\' string to a backslash. */
225 /* A valid line does not end with a backslash. */
238 /* Only `\' or `n' may follow a backslash. */
244 /* The file name may not contain a NUL. */
259 hex_digits (unsigned char const *s
)
270 /* An interface to the function, DIGEST_STREAM,
271 (either md5_stream or sha_stream).
272 Operate on FILENAME (it may be "-") and put the result in *BIN_RESULT.
273 Return non-zero upon failure, zero to indicate success. */
276 digest_file (const char *filename
, int binary
, unsigned char *bin_result
,
277 int (*digest_stream
)(FILE *, void *))
282 if (STREQ (filename
, "-"))
287 /* If we need binary reads from a pipe or redirected stdin, we need
288 to switch it to BINARY mode here, since stdin is already open. */
290 SET_BINARY (fileno (stdin
));
295 /* OPENOPTS is a macro. It varies with the system.
296 Some systems distinguish between internal and
297 external text representations. */
299 fp
= fopen (filename
, OPENOPTS (binary
));
302 error (0, errno
, "%s", filename
);
307 err
= (*digest_stream
) (fp
, bin_result
);
310 error (0, errno
, "%s", filename
);
316 if (fp
!= stdin
&& fclose (fp
) == EOF
)
318 error (0, errno
, "%s", filename
);
326 digest_check (const char *checkfile_name
, int (*digest_stream
)(FILE *, void *))
328 FILE *checkfile_stream
;
329 int n_properly_formated_lines
= 0;
330 int n_mismatched_checksums
= 0;
331 int n_open_or_read_failures
= 0;
332 unsigned char bin_buffer
[MAX_DIGEST_BIN_BYTES
];
335 size_t line_chars_allocated
;
337 if (STREQ (checkfile_name
, "-"))
340 checkfile_name
= _("standard input");
341 checkfile_stream
= stdin
;
345 checkfile_stream
= fopen (checkfile_name
, "r");
346 if (checkfile_stream
== NULL
)
348 error (0, errno
, "%s", checkfile_name
);
353 SET_MODE (fileno (checkfile_stream
), O_TEXT
);
356 line_chars_allocated
= 0;
361 unsigned char *hex_digest
;
367 line_length
= getline (&line
, &line_chars_allocated
, checkfile_stream
);
368 if (line_length
<= 0)
371 /* Ignore comment lines, which begin with a '#' character. */
375 /* Remove any trailing newline. */
376 if (line
[line_length
- 1] == '\n')
377 line
[--line_length
] = '\0';
379 err
= split_3 (line
, line_length
, &hex_digest
, &binary
, &filename
);
380 if (err
|| !hex_digits (hex_digest
))
385 _("%s: %lu: improperly formatted %s checksum line"),
386 checkfile_name
, (unsigned long) line_number
,
387 DIGEST_TYPE_STRING (algorithm
));
392 static const char bin2hex
[] = { '0', '1', '2', '3',
395 'c', 'd', 'e', 'f' };
398 ++n_properly_formated_lines
;
400 fail
= digest_file (filename
, binary
, bin_buffer
, digest_stream
);
404 ++n_open_or_read_failures
;
407 printf (_("%s: FAILED open or read\n"), filename
);
413 size_t digest_bin_bytes
= digest_hex_bytes
/ 2;
415 /* Compare generated binary number with text representation
416 in check file. Ignore case of hex digits. */
417 for (cnt
= 0; cnt
< digest_bin_bytes
; ++cnt
)
419 if (TOLOWER (hex_digest
[2 * cnt
])
420 != bin2hex
[bin_buffer
[cnt
] >> 4]
421 || (TOLOWER (hex_digest
[2 * cnt
+ 1])
422 != (bin2hex
[bin_buffer
[cnt
] & 0xf])))
425 if (cnt
!= digest_bin_bytes
)
426 ++n_mismatched_checksums
;
430 printf ("%s: %s\n", filename
,
431 (cnt
!= digest_bin_bytes
? _("FAILED") : _("OK")));
437 while (!feof (checkfile_stream
) && !ferror (checkfile_stream
));
442 if (ferror (checkfile_stream
))
444 error (0, 0, _("%s: read error"), checkfile_name
);
448 if (checkfile_stream
!= stdin
&& fclose (checkfile_stream
) == EOF
)
450 error (0, errno
, "%s", checkfile_name
);
454 if (n_properly_formated_lines
== 0)
456 /* Warn if no tests are found. */
457 error (0, 0, _("%s: no properly formatted %s checksum lines found"),
458 checkfile_name
, DIGEST_TYPE_STRING (algorithm
));
464 int n_computed_checkums
= (n_properly_formated_lines
465 - n_open_or_read_failures
);
467 if (n_open_or_read_failures
> 0)
470 _("WARNING: %d of %d listed %s could not be read"),
471 n_open_or_read_failures
, n_properly_formated_lines
,
472 (n_properly_formated_lines
== 1
473 ? _("file") : _("files")));
476 if (n_mismatched_checksums
> 0)
479 _("WARNING: %d of %d computed %s did NOT match"),
480 n_mismatched_checksums
, n_computed_checkums
,
481 (n_computed_checkums
== 1
482 ? _("checksum") : _("checksums")));
487 return ((n_properly_formated_lines
> 0 && n_mismatched_checksums
== 0
488 && n_open_or_read_failures
== 0) ? 0 : 1);
492 main (int argc
, char **argv
)
494 unsigned char bin_buffer
[MAX_DIGEST_BIN_BYTES
];
497 char **string
= NULL
;
498 size_t n_strings
= 0;
500 int file_type_specified
= 0;
503 /* Binary is default on MSDOS, so the actual file contents
504 are used in computation. */
507 /* Text is default of the Plumb/Lankester format. */
511 /* Setting values of global variables. */
512 program_name
= argv
[0];
513 setlocale (LC_ALL
, "");
514 bindtextdomain (PACKAGE
, LOCALEDIR
);
515 textdomain (PACKAGE
);
517 atexit (close_stdout
);
519 while ((opt
= getopt_long (argc
, argv
, "bctw", long_options
, NULL
)) != -1)
522 case 0: /* long option */
524 case 1: /* --string */
527 string
= (char **) xmalloc ((argc
- 1) * sizeof (char *));
531 string
[n_strings
++] = optarg
;
535 file_type_specified
= 1;
546 file_type_specified
= 1;
553 case_GETOPT_HELP_CHAR
;
554 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
556 usage (EXIT_FAILURE
);
559 min_digest_line_length
= MIN_DIGEST_LINE_LENGTH (algorithm
);
560 digest_hex_bytes
= DIGEST_HEX_BYTES (algorithm
);
562 if (file_type_specified
&& do_check
)
564 error (0, 0, _("the --binary and --text options are meaningless when \
565 verifying checksums"));
566 usage (EXIT_FAILURE
);
569 if (n_strings
> 0 && do_check
)
572 _("the --string and --check options are mutually exclusive"));
573 usage (EXIT_FAILURE
);
576 if (status_only
&& !do_check
)
579 _("the --status option is meaningful only when verifying checksums"));
580 usage (EXIT_FAILURE
);
583 if (warn
&& !do_check
)
586 _("the --warn option is meaningful only when verifying checksums"));
587 usage (EXIT_FAILURE
);
596 error (0, 0, _("no files may be specified when using --string"));
597 usage (EXIT_FAILURE
);
599 for (i
= 0; i
< n_strings
; ++i
)
602 if (algorithm
== ALG_MD5
)
603 md5_buffer (string
[i
], strlen (string
[i
]), bin_buffer
);
605 sha_buffer (string
[i
], strlen (string
[i
]), bin_buffer
);
607 for (cnt
= 0; cnt
< (digest_hex_bytes
/ 2); ++cnt
)
608 printf ("%02x", bin_buffer
[cnt
]);
610 printf (" \"%s\"\n", string
[i
]);
615 if (optind
+ 1 < argc
)
618 _("only one argument may be specified when using --check"));
619 usage (EXIT_FAILURE
);
622 err
= digest_check ((optind
== argc
) ? "-" : argv
[optind
],
623 DIGEST_STREAM (algorithm
));
630 for (; optind
< argc
; ++optind
)
633 char *file
= argv
[optind
];
635 fail
= digest_file (file
, binary
, bin_buffer
,
636 DIGEST_STREAM (algorithm
));
642 /* Output a leading backslash if the file name contains
643 a newline or backslash. */
644 if (strchr (file
, '\n') || strchr (file
, '\\'))
647 for (i
= 0; i
< (digest_hex_bytes
/ 2); ++i
)
648 printf ("%02x", bin_buffer
[i
]);
656 /* Translate each NEWLINE byte to the string, "\\n",
657 and each backslash to "\\\\". */
658 for (i
= 0; i
< strlen (file
); ++i
)
663 fputs ("\\n", stdout
);
667 fputs ("\\\\", stdout
);
680 if (have_read_stdin
&& fclose (stdin
) == EOF
)
681 error (EXIT_FAILURE
, errno
, _("standard input"));
683 exit (err
== 0 ? EXIT_SUCCESS
: EXIT_FAILURE
);