From owner-freebsd-doc@FreeBSD.ORG Mon May 16 00:00:26 2011 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 468A2106566C for ; Mon, 16 May 2011 00:00:26 +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 03BAB8FC17 for ; Mon, 16 May 2011 00:00:26 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p4G00Pdd022085 for ; Mon, 16 May 2011 00:00:25 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p4G00PgN022084; Mon, 16 May 2011 00:00:25 GMT (envelope-from gnats) Resent-Date: Mon, 16 May 2011 00:00:25 GMT Resent-Message-Id: <201105160000.p4G00PgN022084@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, Warren Block Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 78F2C106564A for ; Sun, 15 May 2011 23:52:12 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 68D318FC0C for ; Sun, 15 May 2011 23:52:12 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p4FNqChJ029813 for ; Sun, 15 May 2011 23:52:12 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p4FNqCuC029812; Sun, 15 May 2011 23:52:12 GMT (envelope-from nobody) Message-Id: <201105152352.p4FNqCuC029812@red.freebsd.org> Date: Sun, 15 May 2011 23:52:12 GMT From: Warren Block To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/157078: [patch] su.1: clarify use of -c as shell argument 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: Mon, 16 May 2011 00:00:26 -0000 >Number: 157078 >Category: docs >Synopsis: [patch] su.1: clarify use of -c as shell argument >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: Mon May 16 00:00:25 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: 8-STABLE >Organization: >Environment: FreeBSD lightning 8.2-STABLE FreeBSD 8.2-STABLE #0: Sat May 14 23:49:51 MDT 2011 root@lightning:/usr/obj/usr/src/sys/LIGHTNING i386 >Description: su(1) uses -c in an example, but does not explain that it is passed to a shell, not su's -c option. >How-To-Repeat: Compare the description of su's -c option in su.1 with the use of -c in the first example. >Fix: Apply patch. Patch attached with submission follows: --- usr.bin/su/su.1.orig 2011-05-15 16:57:35.000000000 -0600 +++ usr.bin/su/su.1 2011-05-15 17:29:24.000000000 -0600 @@ -197,10 +197,9 @@ .Sh EXAMPLES .Bl -tag -width 5n -compact .It Li "su -m man -c catman" -Runs the command -.Li catman -as user -.Li man . +As user +.Li man , start a shell with the arguments +.Dq "-c catman" . You will be asked for man's password unless your real UID is 0. Note that the .Fl m >Release-Note: >Audit-Trail: >Unformatted: