shutdown(8) — AIX PS/2 1.2.1



SHUTDOWN(8,C)               AIX Commands Reference                SHUTDOWN(8,C)



-------------------------------------------------------------------------------
shutdown



PURPOSE

Ends system operation.

SYNTAX


            +-----------+   +------------------------+
shutdown ---| +-------+ |---|          +-----------+ |---|
            +-| -c -m |-+   +- + time -|           |-+
              | -F -n |                +- message -+
              | -h -r |
              | -i -v |
              | -k    |
              +-------+


DESCRIPTION

The shutdown command brings the AIX Operating System from multi-user mode to
maintenance mode, or halts the operating system completely.  You can run
shutdown only if you are a member of the system group, have superuser authority
or are logged in at the console of a PS/2.

Default shutdown halts the operating system.  During the default shutdown,
users are notified (by a wall command) of the impending system shutdown with a
message.  However, the shutdown is not complete until the user receives a
shutdown completion message.  Do not attempt to reboot the system or turn off
the system before the shutdown completion message is displayed; otherwise, file
system damage may result.  Time is the time at which shutdown will bring the
system down and may be the word now (indicating an immediate shutdown) or
specify a future time in one of two formats:  +number and hour:min.  The first
form brings the system down in number minutes and the second brings the system
down at the time of day indicated (as a 24-hour clock).

At intervals which get closer together as shutdown approaches, warning messages
are displayed at the terminals of all users on the system.

During the shutdown, the phold command prevents any new logins.  After the
specified number of minutes (1 by default), if none of the -r, -m or -k flags
are specified, shutdown invokes /etc/halt.  If the -r flag is specified,
shutdown invokes /etc/reboot.  In both cases, all processes are terminated and
all file systems are unmounted.  If the -n flag is not specified, all memory
resident disk blocks are flushed to disk.

If the -r, -m or -k flag was specified, then shutdown will invoke the command
reboot, bring the system down to maintenance (for example single user) mode, or



Processed November 8, 1990       SHUTDOWN(8,C)                                1



SHUTDOWN(8,C)               AIX Commands Reference                SHUTDOWN(8,C)



avoid shutting down the system, respectively.  (If it isn't obvious, -k is to
make people think the system is going down!)

The -i option invokes an interactive shutdown procedure.

Note:  Only users logged onto the machine or logged onto another machine in the
       same TCF cluster will be notified about the shutdown.  Users using this
       machine as a file server (for example, through AIX/NFS or AIX Access for
       DOS Users) will not be notified.

If there are no other users on the system and you want to shutdown the system
quickly, you may want to use shutdown -F.  This option bypasses messages to
users and brings the system down as quickly as possible.

If message is specified, time must be specified.

Warning: For shutdown -m, for example, if you are bringing the system down to
maintenance mode, you must run shutdown from the root directory to ensure that
it can cleanly unmount the file systems.

FLAGS

-c Does not check file system upon rebooting.

-F Does a fast shutdown, bypassing the messages to other users and bringing the
   system down as quickly as possible.  If you do not specify this flag,
   shutdown sends a message to each logged-in user and waits a certain amount
   of time before bringing the system down, to allow each user to log off
   cleanly.

-h Halts the operating system completely.

-i Interactive shutdown.  Guides the user through the shutdown procedure.

-k Avoid shutting down the system.

-m Bring the system down to maintenance mode.

-n Don't sync disks

-r Do a reboot.

-v Halts the operating system completely (same as -h).

EXAMPLES

  1. To tell the operating system you are about to turn off the machine:

      shutdown

    This shuts down the system, waiting 1 minute before stopping the user
    processes and the init process.



Processed November 8, 1990       SHUTDOWN(8,C)                                2



SHUTDOWN(8,C)               AIX Commands Reference                SHUTDOWN(8,C)




  2. To give users and the system more time to finish what they are doing:

      shutdown  -m  +5

    This brings the system down from multi-user mode to maintenance mode after
    waiting 5 minutes.

FILES

/etc/shutdown.sh

RELATED INFORMATION

See the following commands:  "acct/*,"  "errstop,"  "fastboot, fasthalt,"
"halt,"  "init, telinit,"  "kill," "killall,"  "reboot," and  "pdisable,
phold."

See the sigaction system call in AIX Operating System Technical Reference.




































Processed November 8, 1990       SHUTDOWN(8,C)                                3

Museum

Related Articles