Manual Pages for UNIX Operating System command usage for man shutdown

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 machine. 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  console  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 standard warning message "The system
     will be shut down in ..." If the string contains  more  than
     one word, it should be contained within single (') 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  EXAM-
     PLES.


     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)  ser-
                   vices  are unavailable. Note that not all user
                   processes are stopped when transitioning  from
                   multi-user state to state 1.






SunOS 5.11           Last change: 9 May 2001                    1






System Administration Commands                       shutdown(1M)



     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  single-user
                   state,  file  systems  required for multi-user
                   logins are unmounted and the system  can  only
                   be   accessed   through  the  console.  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  speci-
                        fies  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



SunOS 5.11           Last change: 9 May 2001                    2






System Administration Commands                       shutdown(1M)



       ===== 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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


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

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

















SunOS 5.11           Last change: 9 May 2001                    3