From owner-svn-src-stable-7@FreeBSD.ORG Sat Jun 11 00:31:37 2011 Return-Path: Delivered-To: svn-src-stable-7@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E8761106564A; Sat, 11 Jun 2011 00:31:37 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id D85EE8FC14; Sat, 11 Jun 2011 00:31:37 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id p5B0VbDJ050118; Sat, 11 Jun 2011 00:31:37 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id p5B0VbVr050116; Sat, 11 Jun 2011 00:31:37 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201106110031.p5B0VbVr050116@svn.freebsd.org> From: Glen Barber Date: Sat, 11 Jun 2011 00:31:37 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-7@freebsd.org X-SVN-Group: stable-7 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r222966 - stable/7/usr.bin/su X-BeenThere: svn-src-stable-7@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for only the 7-stable src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 11 Jun 2011 00:31:38 -0000 Author: gjb (doc committer) Date: Sat Jun 11 00:31:37 2011 New Revision: 222966 URL: http://svn.freebsd.org/changeset/base/222966 Log: MFC 222758, 222759, 222770: - Document that when running 'su -m -c ', is run within a shell as . - Bump date - Attempt to clear up some confusion in the following example, by stating the '-c' argument is passed to the shell, not to su(1), which would indicate the login class. 'su -m -c ' PR: 157078 Modified: stable/7/usr.bin/su/su.1 Directory Properties: stable/7/usr.bin/su/ (props changed) Modified: stable/7/usr.bin/su/su.1 ============================================================================== --- stable/7/usr.bin/su/su.1 Sat Jun 11 00:30:56 2011 (r222965) +++ stable/7/usr.bin/su/su.1 Sat Jun 11 00:31:37 2011 (r222966) @@ -32,7 +32,7 @@ .\" @(#)su.1 8.2 (Berkeley) 4/18/94 .\" $FreeBSD$ .\" -.Dd July 1, 2008 +.Dd June 6, 2011 .Dt SU 1 .Os .Sh NAME @@ -197,16 +197,22 @@ PAM configuration for .Sh EXAMPLES .Bl -tag -width 5n -compact .It Li "su -m man -c catman" -Runs the command -.Li catman -as user -.Li man . +Starts a shell as user +.Li man , +and runs the command +.Li catman . You will be asked for man's password unless your real UID is 0. Note that the .Fl m option is required since user .Dq man does not have a valid shell by default. +In this example, +.Fl c +is passed to the shell of the user +.Dq man , +and is not interpreted as an argument to +.Nm . .It Li "su -m man -c 'catman /usr/share/man /usr/local/man'" Same as above, but the target command consists of more than a single word and hence is quoted for use with the