From owner-freebsd-bugs  Tue Jan 22  2:30:24 2002
Delivered-To: freebsd-bugs@hub.freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id B4FBA37B420
	for <freebsd-bugs@hub.freebsd.org>; Tue, 22 Jan 2002 02:30:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g0MAU1i02231;
	Tue, 22 Jan 2002 02:30:01 -0800 (PST)
	(envelope-from gnats)
Received: from vexpert.dbai.tuwien.ac.at (vexpert.dbai.tuwien.ac.at [128.130.111.12])
	by hub.freebsd.org (Postfix) with ESMTP id E0B9E37B404
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 22 Jan 2002 02:29:33 -0800 (PST)
Received: from naos.dbai.tuwien.ac.at (naos [128.130.111.28])
	by vexpert.dbai.tuwien.ac.at (8.11.6/8.11.6) with ESMTP id g0MATUB29867;
	Tue, 22 Jan 2002 11:29:30 +0100 (MET)
Received: (from pfeifer@localhost)
	by naos.dbai.tuwien.ac.at (8.11.6/8.11.6) id g0MATTB94370;
	Tue, 22 Jan 2002 11:29:29 +0100 (CET)
	(envelope-from pfeifer)
Message-Id: <200201221029.g0MATTB94370@naos.dbai.tuwien.ac.at>
Date: Tue, 22 Jan 2002 11:29:29 +0100 (CET)
From: Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at>
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.113
Subject: bin/34159: chroot man page-implementation mismatch
Sender: owner-freebsd-bugs@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-bugs.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-bugs>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-bugs>
X-Loop: FreeBSD.org


>Number:         34159
>Category:       bin
>Synopsis:       chroot man page-implementation mismatch
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jan 22 02:30:01 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Gerald Pfeifer
>Release:        FreeBSD 4.4-RELEASE i386
>Organization:
>Environment:
System: FreeBSD naos.dbai.tuwien.ac.at 4.4-RELEASE FreeBSD 4.4-RELEASE #0: Wed Oct 17 12:35:32 CEST 2001 root@naos.dbai.tuwien.ac.at:/usr/src/sys/compile/DBAI i386

>Description:
	I'm not completely sure whether this is a problem with documentation
	or implementation but...

	o 'man chroot' states that "command or the shell are run as your
	real-user-id" whereas it seems that chroot can only be run by
	the super-user.

	o If chroot indeed can only be run by the super-user, this should
	be properly documented, for example:

	    "This command can be run only by the super-user."

	o "exec's command" should most probably read "exec's command relative
	to newroot".
	
>How-To-Repeat:
	man chroot
	chroot /bin -- as regular user
	chroot /bin /bin/csh -- as super-user

>Fix:
	Update man page as described above (or adjust implementation).
>Release-Note:
>Audit-Trail:
>Unformatted:

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