From owner-freebsd-doc@FreeBSD.ORG Fri Aug 15 12:00:13 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0F07937B401 for ; Fri, 15 Aug 2003 12:00:13 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9D20A43FAF for ; Fri, 15 Aug 2003 12:00:11 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h7FJ0BUp014765 for ; Fri, 15 Aug 2003 12:00:11 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h7FJ0Bgp014764; Fri, 15 Aug 2003 12:00:11 -0700 (PDT) Resent-Date: Fri, 15 Aug 2003 12:00:11 -0700 (PDT) Resent-Message-Id: <200308151900.h7FJ0Bgp014764@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, Gregory Neil Shapiro Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B052637B401 for ; Fri, 15 Aug 2003 11:55:42 -0700 (PDT) Received: from spork.sendmail.com (spork.sendmail.com [209.246.26.39]) by mx1.FreeBSD.org (Postfix) with ESMTP id B2B5D43F85 for ; Fri, 15 Aug 2003 11:55:41 -0700 (PDT) (envelope-from gshapiro@sendmail.com) Received: from foon.sendmail.com (smtp.sendmail.com [209.246.26.40]) h7FIteU3005886 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=OK) for ; Fri, 15 Aug 2003 11:55:40 -0700 (PDT) Received: from scooter.smi.sendmail.com (natted.sendmail.com [63.211.143.38]) h7FItdKJ008794 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=OK) for ; Fri, 15 Aug 2003 11:55:40 -0700 Received: from scooter.smi.sendmail.com (localhost [127.0.0.1]) h7FItdUv096481 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 15 Aug 2003 11:55:39 -0700 (PDT) (envelope-from gshapiro@scooter.smi.sendmail.com) Received: (from gshapiro@localhost) by scooter.smi.sendmail.com (8.12.9/8.12.9/Submit) id h7FItd1l096480; Fri, 15 Aug 2003 11:55:39 -0700 (PDT) Message-Id: <200308151855.h7FItd1l096480@scooter.smi.sendmail.com> Date: Fri, 15 Aug 2003 11:55:39 -0700 (PDT) From: Gregory Neil Shapiro To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/55613: su man page confusing, probably incorrect X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Gregory Neil Shapiro List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 15 Aug 2003 19:00:13 -0000 >Number: 55613 >Category: docs >Synopsis: su man page confusing, probably incorrect >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Aug 15 12:00:11 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Gregory Neil Shapiro >Release: FreeBSD 4.8-STABLE i386 >Organization: >Environment: System: FreeBSD scooter.smi.sendmail.com 4.8-STABLE FreeBSD 4.8-STABLE #0: Wed Jul 2 11:53:30 PDT 2003 root@scooter.smi.sendmail.com:/usr/obj/usr/src/sys/SCOOTER i386 >Description: The su man page describes -c as: -c class Use the settings of the specified login class. Only allowed for the super-user. Yet the examples say: su man -c catman Runs the command catman as user man. You will be asked for man's password unless your real UID is 0. su man -c `catman /usr/share/man /usr/local/man /usr/X11R6/man' Same as above, but the target command consists of more than a sin- ... Clearly the -c in these examples is not pointing at a login class. It is pointing at a command to run. Sure a later example gives the even more confusing: su -c staff man -c `catman /usr/share/man /usr/local/man /usr/X11R6/man' However, -c is never documented in the man page as pointing to a command to run, which it in fact does do. Also note in the examples above that the quoting is wrong. If someone actually tries to run the given commands in the example, it will fail. The first quote has to be a normal single quote, not a back quote. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: