From owner-freebsd-doc  Thu Jan 18  8:10:19 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 2E28837B699
	for <freebsd-doc@freebsd.org>; Thu, 18 Jan 2001 08:10:02 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f0IGA2944929;
	Thu, 18 Jan 2001 08:10:02 -0800 (PST)
	(envelope-from gnats)
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 9F21837B402
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 18 Jan 2001 08:02:22 -0800 (PST)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f0IG2Md42090;
	Thu, 18 Jan 2001 08:02:22 -0800 (PST)
	(envelope-from nobody)
Message-Id: <200101181602.f0IG2Md42090@freefall.freebsd.org>
Date: Thu, 18 Jan 2001 08:02:22 -0800 (PST)
From: ches@bell-labs.com
To: freebsd-gnats-submit@freebsd.org
X-Send-Pr-Version: www-1.0
Subject: docs/24434: cipher(3) man pages needs to state that -lcipher is needed.
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         24434
>Category:       docs
>Synopsis:       cipher(3) man pages needs to state that -lcipher is needed.
>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:   Thu Jan 18 08:10:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Bill Cheswick
>Release:        4.2 stable
>Organization:
Lumeta Corporation
>Environment:
FreeBSD ches-netmapper.research.bell-labs.com 4.2-STABLE FreeBSD 4.2-STABLE #1: Sun Nov 26 13:50:34 EST 2000     ches@ches-netmapper.research.bell-labs.com:/usr/src/sys/compile/LOCAL  i386

>Description:
Man pages should mention the libraries that their routines rely on.
It is missing from the cipher(3) man page.  The obvious entries
of -ldes and -lcrypto don't work.

A lot of people are having problems with this.  They see the libc
error messages and think crypto is not available. The search engines
show a lot of queries about:

/var/tmp/ccO60021.o(.text+0x2c): WARNING!  des_cipher(3) not present in the system!

ches
>How-To-Repeat:
ches-netmapper:~/map/dev/ches/snk$ cat t.c
int
main(int argc, char *argv[]) {
        char buf[1000];

        des_setkey("xxx");
        des_cipher(buf, buf, 0, 16);
        setkey("ccc");
        encrypt(buf, 1);
}
ches-netmapper:~/map/dev/ches/snk$ cc t.c
/var/tmp/cck60048.o: In function `main':
/var/tmp/cck60048.o(.text+0x12): WARNING!  des_setkey(3) not present in the system!
/var/tmp/cck60048.o(.text+0x2c): WARNING!  des_cipher(3) not present in the system!
/var/tmp/cck60048.o(.text+0x3c): WARNING!  setkey(3) not present in the system!
/var/tmp/cck60048.o(.text+0x50): WARNING!  encrypt(3) not present in the system!

>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message