Bug 121713

Summary: man page for su contains errornous example.
Product: Documentation Reporter: Chris St Denis <chris>
Component: Books & ArticlesAssignee: Daniel Gerzo <danger>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Chris St Denis 2008-03-14 21:20:01 UTC
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.

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.
Comment 1 Daniel Gerzo freebsd_committer freebsd_triage 2008-06-27 23:31:24 UTC
Hello,

  To fix this problem, we might want to add -m option to the example
  commands. Does this work for you guys? Any other ideas?

-- 
Best regards,
 Daniel                          mailto:danger@FreeBSD.org
Comment 2 Tom Rhodes freebsd_committer freebsd_triage 2008-06-30 18:44:27 UTC
On Sat, 28 Jun 2008 00:31:24 +0200
Daniel Gerzo <danger@freebsd.org> wrote:

> Hello,
> 
>   To fix this problem, we might want to add -m option to the example
>   commands. Does this work for you guys? Any other ideas?

Works for me.

-- 
Tom Rhodes
Comment 3 Daniel Gerzo freebsd_committer freebsd_triage 2008-07-01 21:56:39 UTC
Responsible Changed
From-To: freebsd-doc->danger

Track
Comment 4 dfilter service freebsd_committer freebsd_triage 2008-07-01 21:56:45 UTC
danger      2008-07-01 20:56:23 UTC

  FreeBSD src repository

  Modified files:
    usr.bin/su           su.1 
  Log:
  SVN rev 180155 on 2008-07-01 20:56:23Z by danger
  
  - add the -m option to the example commands because they would fail w/o it
    as the ``man'' user does not have a valid shell by default.
  
  PR:             docs/121713
  Approved by:    trhodes
  MFC after:      3 days
  
  Revision  Changes    Path
  1.41      +9 -4      src/usr.bin/su/su.1
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 5 Daniel Gerzo freebsd_committer freebsd_triage 2008-07-01 21:56:55 UTC
State Changed
From-To: open->patched

I have added the -m option to the example commands
Comment 6 dfilter service freebsd_committer freebsd_triage 2008-07-05 11:48:18 UTC
danger      2008-07-05 10:47:59 UTC

  FreeBSD src repository

  Modified files:        (Branch: RELENG_7)
    usr.bin/su           su.1 
  Log:
  SVN rev 180288 on 2008-07-05 10:47:59Z by danger
  
  MFC r180155:
  
  - add the -m option to the example commands because they would fail w/o it
    as the ``man'' user does not have a valid shell by default.
  
  PR:             docs/121713
  
  Revision  Changes    Path
  1.40.2.1  +9 -4      src/usr.bin/su/su.1
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 7 Daniel Gerzo freebsd_committer freebsd_triage 2008-07-05 12:01:26 UTC
State Changed
From-To: patched->closed

Close this one as I have synced su.1 in RELENG_[76] with -HEAD
Comment 8 dfilter service freebsd_committer freebsd_triage 2008-07-05 12:01:35 UTC
danger      2008-07-05 11:01:11 UTC

  FreeBSD src repository

  Modified files:        (Branch: RELENG_6)
    usr.bin/su           su.1 
  Log:
  SVN rev 180289 on 2008-07-05 11:01:11Z by danger
  
  MFC r162792 [1], r171562 [2], r180155 [3]:
  
  - markup fixes [1]
  - Stop mentioning /usr/X11R6 [2]
  - add the -m option to the example commands because they would fail w/o it
    as the ``man'' user does not have a valid shell by default. [3]
  
  PR:             docs/121713 [3]
  
  Revision  Changes    Path
  1.36.2.3  +12 -7     src/usr.bin/su/su.1
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"