From owner-freebsd-doc@FreeBSD.ORG Sat Mar 29 10:10:00 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id CC054ACA for ; Sat, 29 Mar 2014 10:10:00 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id A7F3BE59 for ; Sat, 29 Mar 2014 10:10:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.8/8.14.8) with ESMTP id s2TAA0nP089017 for ; Sat, 29 Mar 2014 10:10:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.8/8.14.8/Submit) id s2TAA0B0089016; Sat, 29 Mar 2014 10:10:00 GMT (envelope-from gnats) Resent-Date: Sat, 29 Mar 2014 10:10:00 GMT Resent-Message-Id: <201403291010.s2TAA0B0089016@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jamie Landeg-Jones Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 223F8ABC for ; Sat, 29 Mar 2014 10:08:28 +0000 (UTC) Received: from pacha.mail.dyslexicfish.net (space.mail.dyslexicfish.net [91.109.5.35]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 9B44CE50 for ; Sat, 29 Mar 2014 10:08:22 +0000 (UTC) Received: from catnip.dyslexicfish.net (space.mail.dyslexicfish.net [91.109.5.35]) by pacha.mail.dyslexicfish.net (8.14.5/8.14.5) with ESMTP id s2T9pSgg028623 for ; Sat, 29 Mar 2014 09:51:29 GMT (envelope-from jamie@catnip.dyslexicfish.net) Received: (from jamie@localhost) by catnip.dyslexicfish.net (8.14.5/8.14.5/Submit) id s2T9pS9u028622; Sat, 29 Mar 2014 09:51:28 GMT (envelope-from jamie) Message-Id: <201403290951.s2T9pS9u028622@catnip.dyslexicfish.net> Date: Sat, 29 Mar 2014 09:51:28 GMT From: Jamie Landeg-Jones To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/188043: man page for md5/sha1/sha256/sha412/rmd-160 cleanup X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list Reply-To: Jamie Landeg-Jones List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 29 Mar 2014 10:10:01 -0000 >Number: 188043 >Category: docs >Synopsis: man page for md5/sha1/sha256/sha412/rmd-160 cleanup >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Mar 29 10:10:00 UTC 2014 >Closed-Date: >Last-Modified: >Originator: Jamie Landeg-Jones >Release: FreeBSD 10.0-STABLE amd64 >Organization: Dyslexic Fish >Environment: System: FreeBSD catnip.dyslexicfish.net 10.0-STABLE FreeBSD 10.0-STABLE #0: Wed Jan 22 09:10:20 GMT 2014 root@catflap.dyslexicfish.net:/usr/obj/usr/src/sys/CATFLAP amd64 >Description: man page shows for -c option: "Compare files to this md5 string." This is misleading - the string needs to be in the same format as the digest command being used. I suggest something like: "Compare the files message digest to this string." Also, suggest updating the date relating to known exploits. >How-To-Repeat: man sha1 man sha256 man sha512 man rmd-160 >Fix: Apply attached patch suggestion --- patch-md5.1 begins here --- --- md5.1.orig 2014-02-17 01:41:53.000000000 +0000 +++ md5.1 2014-03-29 09:35:16.000000000 +0000 @@ -63,12 +63,12 @@ This also means that .Tn MD5 should not be used as part of a cryptographic signature scheme. -At the current time (2009-01-06) there is no publicly known method to +At the current time (2014-03-28) there is no publicly known method to .Dq reverse MD5, i.e., to find an input given a hash value. .Pp .Tn SHA-1 -currently (2009-01-06) has no known collisions, but an attack has been +currently (2014-03-28) has no known collisions, but an attack has been found which is faster than a brute-force search, placing the security of .Tn SHA-1 in doubt. @@ -83,7 +83,7 @@ after the options are processed. .Bl -tag -width indent .It Fl c Ar string -Compare files to this md5 string. +Compare the files message digest to this string. (Note that this option is not yet useful if multiple files are specified.) .It Fl s Ar string Print a checksum of the given --- patch-md5.1 ends here --- >Release-Note: >Audit-Trail: >Unformatted: