Bug 129765

Summary:	shutdown(8) does not explain operation without command-line options
Product:	Documentation	Reporter:	freebsd
Component:	Books & Articles	Assignee:	Tom Rhodes <trhodes>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description freebsd 2008-12-19 17:00:02 UTC

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.

Comment 1 Tom Rhodes freebsd_committer

2008-12-23 15:00:30 UTC

State Changed
From-To: open->patched

I have committed a change to shutdown.8, thanks!

Comment 2 Tom Rhodes freebsd_committer

2008-12-23 15:00:30 UTC

Responsible Changed
From-To: freebsd-doc->trhodes

Over to me, MFC reminder.

Comment 3 Ben.Grimm 2009-02-04 14:52:37 UTC

MFC postponed or in the works?

Comment 4 dfilter service freebsd_committer

2009-04-01 07:01:50 UTC

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"

Comment 5 dfilter service freebsd_committer

2009-04-01 07:19:11 UTC

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"

Comment 6 Tom Rhodes freebsd_committer

2009-04-01 07:19:28 UTC

State Changed
From-To: patched->closed

MFC to both 6 and 7 complete, thanks!

Comment 7 freebsd 2009-04-01 09:36:10 UTC

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.