NAME

halt − Stops the processor

SYNOPSIS

/usr/sbin/halt [−d] [−l] [−n] [−q] [−y]

OPTIONS

−dGenerates a crash dump of the system before halting it.  Can be used with any other option. 

−lDoes not log the halt using syslog. 

−nPrevents the sync before stopping, and does not log the halt using syslog. 

−qCauses a quick halt, does not log the halt using syslog, and makes no attempt to kill all processes. 

−yHalts the system from a dial-up operation. 

DESCRIPTION

If other users are logged into the system, or if the system is operating at a multiuser run level, use the /usr/sbin/shutdown −h command to halt the system.  If only the root user is logged in, and you do not plan to restart the system immediately, use the halt command. 

The halt command writes data to the disks and then stops the processor(s), but does not reboot the machine. 

You must be the root user to run this command. 

When the system displays the ...Halt completed... message, you can turn off power to the machine. 

If the command is invoked without the −l, −n, or −q option, the halt program logs the shutdown using the syslogd command and places a record of the shutdown in the login accounting file, /var/adm/wtmp.  Using the −q and the −n options imply the −l option. 

EXAMPLES

     1.To halt the system without logging the shutdown in the log file, enter:

halt -l

     2.To halt the system quickly, enter:

halt -q

     3.To halt the system quickly, also leaving a crash dump for the savecore command, enter:

halt -d -q

     4.To halt the system from a dial-up, enter:

halt -y

FILES

/usr/sbin/halt
Specifies the command path.

/usr/sbin/syslogd
Specifies the syslog daemon.

/var/adm/wtmp
Specifies the login accounting file.

SEE ALSO

Commands: fasthalt(8), reboot(8), savecore(8), shutdown(8), syslogd(8)

Functions: reboot(2), sync(2), syslog(3)