From 42e1abfa34057afbdac7c30120001e077876d10f Mon Sep 17 00:00:00 2001 From: Dmitry Belyavskiy Date: Mon, 28 Aug 2017 15:24:00 +0300 Subject: [PATCH] Mans from master --- gost12sum.1 | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++++ gostsum.1 | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 169 insertions(+) create mode 100644 gost12sum.1 create mode 100644 gostsum.1 diff --git a/gost12sum.1 b/gost12sum.1 new file mode 100644 index 0000000..9c49e18 --- /dev/null +++ b/gost12sum.1 @@ -0,0 +1,84 @@ +.\" Hey, Emacs! This is an -*- nroff -*- source file. +.TH GOST12SUM 1 "02 Aug 2016" "Openssl" "Debian GNU/Linux" +.SH NAME +gost12sum \- generates or checks GOST R34.11-2012 message digests + +.SH SYNOPSIS +.B gost12sum +[\-bvl] [\-c [file]] | [file...] + +.SH DESCRIPTION +.B gost12sum +generates or checks GOST hash sums. The algorithm to generate the +is reasonably fast and strong enough for most cases. Exact +specification of the algorithm is in +.I GOST R34.11-2012. + +Normally +.B gost12sum +generates checksums of all files given to it as a parameter and prints +the checksums followed by the filenames. If, however, +.B \-c +is specified, only one filename parameter is allowed. This file should +contain checksums and filenames to which these checksums refer to, and +the files listed in that file are checked against the checksums listed +there. See option +.B \-c +for more information. + +.SS OPTIONS +.TP +.B \-b +Use binary mode. In unix environment, only difference between this and +the normal mode is an asterisk preceding the filename in the output. +.TP +.B \-c +Check gost hashes of all files listed in +.I file +against the checksum listed in the same file. The actual format of that +file is the same as output of +.B md5sum. +That is, each line in the file describes a file. A line looks like: + +.B + +So, for example, if a file was created and its message digest calculated +like so: + +.B echo foo > hash\-test\-file; gost12sum hash\-test\-file + +.B gost12sum +would report: + +3d4a51ee7713e6467442facefe06f153a303e7bdefbe7f9bdf2edb4ae9c866ff hash\-test\-file + +When invoked with \-c option +.B gost12sum +normally works silently unless error found. Use \-v if you want to see +list of successfully checked files + +.TP +.B \-v +Be more verbose. Print filenames when checking (with \-c). + +.TP +.B -l +Use long (512-bit) hash instead of short (256-bit). + +.SH BUGS + +This manpage is not quite accurate and has formatting inconsistent +with other manpages. + +.B gost12sum +does not accept standard options like +.BR \-\-help . + +.SH AUTHOR + +.B gost12sum +utility written by Cryptocom LTD + +This manual page is written by Victor Wagner for +Debian GNU/Linux + diff --git a/gostsum.1 b/gostsum.1 new file mode 100644 index 0000000..e888945 --- /dev/null +++ b/gostsum.1 @@ -0,0 +1,85 @@ +.\" Hey, Emacs! This is an -*- nroff -*- source file. +.TH GOSTSUM 1 "02 Aug 2017" "Openssl" "Debian GNU/Linux" +.SH NAME +gostsum \- generates or checks GOST R34.11-94 message digests + +.SH SYNOPSIS +.B gostsum +[\-bvt] [\-c [file]] | [file...] + +.SH DESCRIPTION +.B gostsum +generates or checks GOST hash sums. The algorithm to generate the +is reasonably fast and strong enough for most cases. Exact +specification of the algorithm is in +.I GOST R34.11-94. + +Normally +.B gostsum +generates checksums of all files given to it as a parameter and prints +the checksums followed by the filenames. If, however, +.B \-c +is specified, only one filename parameter is allowed. This file should +contain checksums and filenames to which these checksums refer to, and +the files listed in that file are checked against the checksums listed +there. See option +.B \-c +for more information. + +.SS OPTIONS +.TP +.B \-b +Use binary mode. In unix environment, only difference between this and +the normal mode is an asterisk preceding the filename in the output. +.TP +.B \-c +Check gost hashes of all files listed in +.I file +against the checksum listed in the same file. The actual format of that +file is the same as output of +.B md5sum. +That is, each line in the file describes a file. A line looks like: + +.B + +So, for example, if a file was created and its message digest calculated +like so: + +.B echo foo > hash\-test\-file; gostsum hash\-test\-file + +.B gostsum +would report: + +1541e09d0aa5971f732991ae1bdfb63f2609edd7536b40f8c2ae7c1e2f99e072 hash-test-file + +.TP +.B \-v +Be more verbose. Print filenames when checking (with \-c). + +.TP +.B -t +Use test parameter set. +.B gostsum supports two sets of parameters (which are really parameters +of GOST 28147-89 block cipher) specified in the IETF draft +.B draft-popov-cryptopro-cpalgs-02.txt +By default, cryptopro paramset is used. This option enables use of test +paramset as specified in appendices to the GOST. + +.SH CAVEATS + +The output of gost12sum has a reversed byte order compared to output of +.B openssl dgst +command because of the Russian GOST requrements. + +.SH BUGS + +This manpage is not quite accurate and has formatting inconsistent +with other manpages. + +.B gostsum +does not accept standard options like +.BR \-\-help . + +.SH AUTHOR + Victor Wagner + -- 2.39.2