From owner-freebsd-doc@FreeBSD.ORG Fri Mar 14 21:20:01 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E8AA51065670 for ; Fri, 14 Mar 2008 21:20:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id C7F4E8FC15 for ; Fri, 14 Mar 2008 21:20:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m2ELK13O055884 for ; Fri, 14 Mar 2008 21:20:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m2ELK1LJ055883; Fri, 14 Mar 2008 21:20:01 GMT (envelope-from gnats) Resent-Date: Fri, 14 Mar 2008 21:20:01 GMT Resent-Message-Id: <200803142120.m2ELK1LJ055883@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, Chris St Denis Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AA31B106566B for ; Fri, 14 Mar 2008 21:11:57 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 9BB7C8FC24 for ; Fri, 14 Mar 2008 21:11:57 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m2EL8aNT056411 for ; Fri, 14 Mar 2008 21:08:36 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.2/8.14.1/Submit) id m2EL8ajM056410; Fri, 14 Mar 2008 21:08:36 GMT (envelope-from nobody) Message-Id: <200803142108.m2EL8ajM056410@www.freebsd.org> Date: Fri, 14 Mar 2008 21:08:36 GMT From: Chris St Denis To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/121713: man page for su contains errornous example. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 14 Mar 2008 21:20:02 -0000 >Number: 121713 >Category: docs >Synopsis: man page for su contains errornous example. >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: Fri Mar 14 21:20:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Chris St Denis >Release: 7.0-RELEASE >Organization: Smarttnet >Environment: FreeBSD 7.0-RELEASE FreeBSD 7.0-RELEASE #1: Mon Feb 25 11:51:25 PST 2008 i386 >Description: the man page for the "su" command contains the examples 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' Same as above, but the target command consists of more than a sin- gle word and hence is quoted for use with the -c option being passed to the shell. (Most shells expect the argument to -c to be a single word). These examples do not work because man has the nologin shell, producing the results mail# su man -c catman This account is currently not available. >How-To-Repeat: >Fix: These examples should be changed or removed. Since there doesn't appear to be any BSD equivalent of the linux --shell parameter for su another user & command will have to be chosen. >Release-Note: >Audit-Trail: >Unformatted: