The manual for shutdown(8) describes how the command behaves using command-line options like -h or -p, but not the behavior when omitting these options, like in 'shutdown now'. There is a brief mention of 'bringing the system down to single-user state' (which is what 'shutdown now' actually does), but it is not explained. See how this might confuse users: http://forums.freebsd.org/showthread.php?p=6273 Fix: Add a one-liner to the manual about the effect of not using command-line switches in the shutdown command.
State Changed From-To: open->patched I have committed a change to shutdown.8, thanks!
Responsible Changed From-To: freebsd-doc->trhodes Over to me, MFC reminder.
MFC postponed or in the works?
Author: trhodes Date: Wed Apr 1 06:01:40 2009 New Revision: 190605 URL: http://svn.freebsd.org/changeset/base/190605 Log: MFC r186431: Note that when shutdown is run without options, it will place the system into single user mode at the time specified. PR: 129765 Approved by: re (kib) Modified: stable/7/sbin/shutdown/ (props changed) stable/7/sbin/shutdown/shutdown.8 Modified: stable/7/sbin/shutdown/shutdown.8 ============================================================================== --- stable/7/sbin/shutdown/shutdown.8 Wed Apr 1 04:36:37 2009 (r190604) +++ stable/7/sbin/shutdown/shutdown.8 Wed Apr 1 06:01:40 2009 (r190605) @@ -28,7 +28,7 @@ .\" @(#)shutdown.8 8.2 (Berkeley) 4/27/95 .\" $FreeBSD$ .\" -.Dd December 11, 1998 +.Dd December 23, 2008 .Dt SHUTDOWN 8 .Os .Sh NAME @@ -167,6 +167,12 @@ The file that .Nm created will be removed automatically. +.Pp +When run without options, the +.Nm +utility will place the system into single user mode at the +.Ar time +specified. .Sh FILES .Bl -tag -width /var/run/nologin -compact .It Pa /var/run/nologin _______________________________________________ svn-src-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Author: trhodes Date: Wed Apr 1 06:18:51 2009 New Revision: 190607 URL: http://svn.freebsd.org/changeset/base/190607 Log: MFC r186431: Note that when shutdown is run without options, it will place the system into single user mode at the time specified. PR: 129765 Modified: stable/6/sbin/shutdown/ (props changed) stable/6/sbin/shutdown/shutdown.8 Modified: stable/6/sbin/shutdown/shutdown.8 ============================================================================== --- stable/6/sbin/shutdown/shutdown.8 Wed Apr 1 06:03:23 2009 (r190606) +++ stable/6/sbin/shutdown/shutdown.8 Wed Apr 1 06:18:51 2009 (r190607) @@ -28,7 +28,7 @@ .\" @(#)shutdown.8 8.2 (Berkeley) 4/27/95 .\" $FreeBSD$ .\" -.Dd December 11, 1998 +.Dd December 23, 2008 .Dt SHUTDOWN 8 .Os .Sh NAME @@ -167,6 +167,12 @@ The file that .Nm created will be removed automatically. +.Pp +When run without options, the +.Nm +utility will place the system into single user mode at the +.Ar time +specified. .Sh FILES .Bl -tag -width /var/run/nologin -compact .It Pa /var/run/nologin _______________________________________________ svn-src-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
State Changed From-To: patched->closed MFC to both 6 and 7 complete, thanks!
trhodes@FreeBSD.org wrote: > Synopsis: shutdown(8) does not explain operation without command-line options > > State-Changed-From-To: patched->closed > State-Changed-By: trhodes > State-Changed-When: Wed Apr 1 06:19:28 UTC 2009 > State-Changed-Why: > MFC to both 6 and 7 complete, thanks! > > http://www.freebsd.org/cgi/query-pr.cgi?pr=129765 Thanks, guys! Ben, a.k.a. DutchDaemon, FreeBSD Forums.