From alane@geeksrus.net  Mon Feb 11 06:43:05 2002
Return-Path: <alane@geeksrus.net>
Received: from wwweasel.geeksrus.net (wwweasel.geeksrus.net [64.8.210.226])
	by hub.freebsd.org (Postfix) with ESMTP id F16CF37B421
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 11 Feb 2002 06:43:02 -0800 (PST)
Received: (from alane@localhost)
	by wwweasel.geeksrus.net (8.11.6/8.11.6) id g1BEgZk06018;
	Mon, 11 Feb 2002 09:42:35 -0500 (EST)
	(envelope-from alane)
Message-Id: <200202111442.g1BEgZk06018@wwweasel.geeksrus.net>
Date: Mon, 11 Feb 2002 09:42:35 -0500 (EST)
From: Alan Eldridge <ports@geeksrus.net>
Reply-To: Alan Eldridge <ports@geeksrus.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: /usr/share/man/cat3/setkey.3.gz linked to crypt.3.gz, not cipher.3.gz
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         34832
>Category:       bin
>Synopsis:       /usr/share/man/cat3/setkey.3.gz linked to crypt.3.gz, not cipher.3.gz
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    vwe
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 11 06:50:03 PST 2002
>Closed-Date:    Sat May 24 16:02:50 UTC 2008
>Last-Modified:  Sat May 24 16:02:50 UTC 2008
>Originator:     Alan Eldridge
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
Geeksrus.NET
>Environment:
System: FreeBSD wwweasel.geeksrus.net 4.5-STABLE FreeBSD 4.5-STABLE #0: Fri Feb 8 21:25:34 EST 2002 root@wwweasel.geeksrus.net:/usr/obj/usr/src/sys/WWWEASEL i386

>Description:

On a fresh 4.5-RELEASE installation, /usr/share/man/cat3/setkey.3.gz is the
same file as crypt.3.gz.

It should be hard-linked to cipher.3.gz. 

Note: It's correct in /usr/share/man/man3. Only cat3 has the error.

[blank lines inserted for readability]
[alane ~]$ ls -l /usr/share/man/{man,cat}3/{setkey,cipher,crypt}.3*

-rw-r--r--  1 man   wheel  1389 Feb 11 08:37 /usr/share/man/cat3/cipher.3.gz
-rw-r--r--  7 man   wheel  2799 Jan 28 09:35 /usr/share/man/cat3/crypt.3.gz
-rw-r--r--  7 man   wheel  2799 Jan 28 09:35 /usr/share/man/cat3/setkey.3.gz

-r--r--r--  5 root  wheel  2019 Jan 28 08:13 /usr/share/man/man3/cipher.3.gz
-r--r--r--  3 root  wheel  3402 Jan 28 08:11 /usr/share/man/man3/crypt.3.gz
-r--r--r--  5 root  wheel  2019 Jan 28 08:13 /usr/share/man/man3/setkey.3.gz

>How-To-Repeat:

>Fix:




>Release-Note:
>Audit-Trail:

From: "Crist J. Clark" <cjc@FreeBSD.ORG>
To: Alan Eldridge <ports@geeksrus.net>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: bin/34832: /usr/share/man/cat3/setkey.3.gz linked to crypt.3.gz, not cipher.3.gz
Date: Mon, 11 Feb 2002 15:30:44 -0800

 On Mon, Feb 11, 2002 at 09:42:35AM -0500, Alan Eldridge wrote:
 [snip]
 
 > >Description:
 > 
 > On a fresh 4.5-RELEASE installation, /usr/share/man/cat3/setkey.3.gz is the
 > same file as crypt.3.gz.
 > 
 > It should be hard-linked to cipher.3.gz. 
 > 
 > Note: It's correct in /usr/share/man/man3. Only cat3 has the error.
 > 
 > [blank lines inserted for readability]
 > [alane ~]$ ls -l /usr/share/man/{man,cat}3/{setkey,cipher,crypt}.3*
 > 
 > -rw-r--r--  1 man   wheel  1389 Feb 11 08:37 /usr/share/man/cat3/cipher.3.gz
 > -rw-r--r--  7 man   wheel  2799 Jan 28 09:35 /usr/share/man/cat3/crypt.3.gz
 > -rw-r--r--  7 man   wheel  2799 Jan 28 09:35 /usr/share/man/cat3/setkey.3.gz
 > 
 > -r--r--r--  5 root  wheel  2019 Jan 28 08:13 /usr/share/man/man3/cipher.3.gz
 > -r--r--r--  3 root  wheel  3402 Jan 28 08:11 /usr/share/man/man3/crypt.3.gz
 > -r--r--r--  5 root  wheel  2019 Jan 28 08:13 /usr/share/man/man3/setkey.3.gz
 
 This is a problem with the way the catpages are distributed. Right
 now, they are a separate distro. They are built for a "default"
 install. In such a default install, the des_cipher(3), des_setkey(3),
 encrypt(3), and setkey(3) are all linked to crypt(3). When you add the
 'crypto' distribution, it correctly clobbers the manpages as you have
 seen, but it does not do the catpages (since catpages are a separate
 distro and other distros do not contain catpages).
 
 The workaround for this is not as easy as it could be; catman(1)
 won't see the current inconsistencies in your man and catpages,
 
   # cd /usr/share/man/cat3
   # rm cipher.3.gz des_cipher.3.gz des_setkey.3.gz encrypt.3.gz setkey.3.gz
   # echo /usr/bin/catman | su -m man
 
 There may be other inconsistencies between your catpages and
 manpages. I'd actually recommend that instead of the above, you
 rebuild them all,
 
   # find /usr/share/man/cat* -type f -delete
   # echo /usr/bin/catman | su -m man
 
 It takes a few minutes, but it is a one time cost.
 
 As for a fix, too late for 4.5-RELEASE, obviously. Off the top of my
 head, I cannot really think of an easy way to do this. We do not want
 the crypto, or other distros, adding catpages unconditionally. There
 is no good way to let the catman distro know which other distros were
 chosen and add the appropriate catpages; that's not how the distros
 work. The only reasonable possibility I can think of that fits the
 current distro model is to have a separate crypto-catpages (like there
 is already a separate crypto-src) sub-distro.
 
 OTOH, IMHO, probably the best thing to do would be to do away with the
 catman distro all together and have sysinstall run catman(1) after all
 manpages are installed and guarantee that the two are in sync.
 -- 
 Crist J. Clark                     |     cjclark@alum.mit.edu
                                    |     cjclark@jhu.edu
 http://people.freebsd.org/~cjc/    |     cjc@freebsd.org

From: Alan Eldridge <alane@geeksrus.net>
To: "Crist J. Clark" <cjc@FreeBSD.ORG>
Cc: Alan Eldridge <ports@geeksrus.net>,
	FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: bin/34832: /usr/share/man/cat3/setkey.3.gz linked to crypt.3.gz, not cipher.3.gz
Date: Mon, 11 Feb 2002 18:50:07 -0500

 On Mon, Feb 11, 2002 at 03:30:44PM -0800, Crist J. Clark wrote:
 >On Mon, Feb 11, 2002 at 09:42:35AM -0500, Alan Eldridge wrote:
 >[snip]
 
 >This is a problem with the way the catpages are distributed. Right
 >now, they are a separate distro. They are built for a "default"
 
 >The workaround for this is not as easy as it could be; catman(1)
 >won't see the current inconsistencies in your man and catpages,
 >
 >  # cd /usr/share/man/cat3
 >  # rm cipher.3.gz des_cipher.3.gz des_setkey.3.gz encrypt.3.gz setkey.3.gz
 >  # echo /usr/bin/catman | su -m man
 >
 >There may be other inconsistencies between your catpages and
 >manpages. I'd actually recommend that instead of the above, you
 >rebuild them all,
 >
 >  # find /usr/share/man/cat* -type f -delete
 >  # echo /usr/bin/catman | su -m man
 >
 >It takes a few minutes, but it is a one time cost.
 
 Ah...now is there a way to say "find all files that are dupes
 of each other and (hard-or-sym) link 'em together"?
 
 From "man catman":
 
 BUGS
      man(1) is a setuid program.  Be careful that user `man' has write permis-
      sions to the catman directories.  Catman does not check for any `.so' in
      man page sources.  Use hard or symlinks to avoid redundant formatted man
      pages.
 
 I presume this means that it *doesn't* use hard or symlinks on its own.
 
 -- 
 Alan Eldridge
 "Dave's not here, man."

From: "Crist J. Clark" <cjc@FreeBSD.ORG>
To: Alan Eldridge <alane@geeksrus.net>
Cc: bug-followup@FreeBSD.ORG
Subject: Re: bin/34832: /usr/share/man/cat3/setkey.3.gz linked to crypt.3.gz, not cipher.3.gz
Date: Mon, 11 Feb 2002 17:02:50 -0800

 On Mon, Feb 11, 2002 at 04:00:02PM -0800, Alan Eldridge wrote:
 [snip]
 
 >  >  # find /usr/share/man/cat* -type f -delete
 >  >  # echo /usr/bin/catman | su -m man
 >  >
 >  >It takes a few minutes, but it is a one time cost.
 >  
 >  Ah...now is there a way to say "find all files that are dupes
 >  of each other and (hard-or-sym) link 'em together"?
 >  
 >  From "man catman":
 >  
 >  BUGS
 >       man(1) is a setuid program.  Be careful that user `man' has write permis-
 >       sions to the catman directories.  Catman does not check for any `.so' in
 >       man page sources.  Use hard or symlinks to avoid redundant formatted man
 >       pages.
 >  
 >  I presume this means that it *doesn't* use hard or symlinks on its own.
 
 I'm a bit confused by that BUGS section too. catman(1) _does_ do links
 properly. Run,
 
   # echo /usr/bin/catman -p -v | su -m man
 
 To see what it will do. I _think_ the BUGS section is saying to link
 or symlink your _manpages._ That's how catman(1) knows when to link
 rather than reprocess.
 -- 
 Crist J. Clark                     |     cjclark@alum.mit.edu
                                    |     cjclark@jhu.edu
 http://people.freebsd.org/~cjc/    |     cjc@freebsd.org
State-Changed-From-To: open->closed 
State-Changed-By: vwe 
State-Changed-When: Sat May 24 16:02:11 UTC 2008 
State-Changed-Why:  

setkey(3) does not exist anymore - closing this 


Responsible-Changed-From-To: freebsd-bugs->vwe 
Responsible-Changed-By: vwe 
Responsible-Changed-When: Sat May 24 16:02:11 UTC 2008 
Responsible-Changed-Why:  

track 

http://www.freebsd.org/cgi/query-pr.cgi?pr=34832 
>Unformatted:
