Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
shutdown(1M)		System Administration Commands		  shutdown(1M)

NAME
       shutdown	- shut down system, change system state

SYNOPSIS
       /usr/sbin/shutdown [-y] [-g grace-period] [-i init-state] [message]

DESCRIPTION
       shutdown	 is  executed by the super user	to change the state of the ma-
       chine. In most cases, it	is used	to change from	the  multi-user	 state
       (state 2) to another state.

       By  default,  shutdown brings the system	to a state where only the con-
       sole has	access to the operating	system.	This state is  called  single-
       user.

       Before  starting	 to  shut down daemons and killing processes, shutdown
       sends a warning message and, by default,	a  final  message  asking  for
       confirmation.  message is a string that is sent out following the stan-
       dard warning message "The system	will be	 shut  down  in	 ..."  If  the
       string  contains	more than one word, it should be contained within sin-
       gle (') or double (") quotation marks.

       The warning message and the user	provided message are output when there
       are 7200, 3600, 1800, 1200, 600,	300, 120, 60, and 30 seconds remaining
       before shutdown begins. See EXAMPLES.

       System state definitions	are:

       state 0
	     Stop the operating	system.

       state 1
	     State 1 is	referred to as the administrative state.  In  state  1
	     file  systems required for	multi-user operations are mounted, and
	     logins requiring access to	multi-user file	systems	can  be	 used.
	     When  the	system	comes up from firmware mode into state 1, only
	     the console is active and other multi-user	(state 2) services are
	     unavailable.  Note	 that  not all user processes are stopped when
	     transitioning from	multi-user state to state 1.

       state s,	S
	     State s (or S) is referred	to as the single-user state. All  user
	     processes	are  stopped on	transitions to this state. In the sin-
	     gle-user state, file systems required for multi-user  logins  are
	     unmounted	and  the  system can only be accessed through the con-
	     sole. Logins requiring access to multi-user file  systems	cannot
	     be	used.

       state 5
	     Shut  the	machine	 down  so that it is safe to remove the	power.
	     Have the machine remove power, if possible. The rc0 procedure  is
	     called to perform this task.

       state 6
	     Stop  the operating system	and reboot to the state	defined	by the
	     initdefault entry in /etc/inittab.	The rc6	procedure is called to
	     perform this task.

OPTIONS
       -y    Pre-answer	 the  confirmation  question so	the command can	be run
	     without user intervention.

       -g grace-period
	     Allow the super user to change the	number	of  seconds  from  the
	     60-second default.

       -i init-state
	     If	 there are warnings, init-state	specifies the state init is to
	     be	in. By default,	system state `s' is used.

EXAMPLES
       Example 1: Using	shutdown

       In the following	example, shutdown is being executed on host foo	and is
       scheduled  in  120  seconds. The	warning	message	is output 2 minutes, 1
       minute, and 30 seconds before the final confirmation message.

       example#	shutdown -i S -g 120 "===== disk replacement ====="
       Shutdown	started.   Tue Jun   7	14:51:40 PDT  1994

       Broadcast Message from root (pts/1) on foo Tue Jun  7 14:51:41...
       The system will be shut down in 2 minutes
       ===== disk replacement =====
       Broadcast Message from root (pts/1) on foo Tue Jun  7 14:52:41...
       The system will be shut down in 1 minutes
       ===== disk replacement =====
       Broadcast Message from root (pts/1) on foo Tue Jun  7 14:53:41...
       The system will be shut down in 30 seconds
       ===== disk replacement =====
       Do you want to continue?	(y or n):

FILES
       /etc/inittab
	     controls process dispatching by init

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       boot(1M), halt(1M),  init(1M),  killall(1M),  reboot(1M),  ufsdump(1M),
       init.d(4), inittab(4), nologin(4), attributes(5)

NOTES
       When  a	system	transitions down to the	S or s state, the /etc/nologin
       file (see nologin(4)) is	created.  Upon subsequent transition to	 state
       2  (multi-user  state),	this  file  is	removed	 by  a	script	in the
       /etc/rc2.d directory.

SunOS 5.9			  9 May	2001			  shutdown(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | FILES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=shutdown&sektion=1m&manpath=SunOS+5.9>

home | help