[unix-history] / usr / src / sbin / reboot / halt.8

.\" Copyright (c) 1980, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)halt.8	6.5 (Berkeley) %G%
.\"
.Dd 
.Dt HALT 8
.Os BSD 4
.Sh NAME
.Nm halt
.Nd stop the processor
.Sh SYNOPSIS
.Nm halt
.Op Fl n
.Op Fl q
.Op Fl y
.Sh DESCRIPTION
.Nm Halt
writes out sandbagged information to the disks and then stops
the processor.  The machine does not reboot, even if the auto-reboot
switch is set on the console.
.Pp
Available options for
.Nm halt :
.Bl -tag -width Ds
.It Fl n
No sync before stopping.
.It Fl q
Quick halt, no graceful shutdown is attempted.
.It Fl y
This option is needed if you are trying to halt the system from a dialup.
.El
.Pp
.Nm Halt
normally logs the shutdown using
.Xr syslog 8
and places a shutdown record in the login accounting file
.Pa /var/log/wtmp.
These actions are inhibited if the
.Fl n
or
.Fl q
options are present.
.Sh SEE ALSO
.Xr reboot 8 ,
.Xr shutdown 8 ,
.Xr syslogd 8
.Sh BUGS
It is very difficult to halt a
.Tn VAX ,
as the machine wants to then
reboot itself.  A rather tight loop suffices.
.Sh HISTORY
The
.Nm
command appeared in
.Bx 4.0 .
Commit	Line	Data
0fccfdb8	1	.\" Copyright (c) 1980, 1991 The Regents of the University of California.
5bcf4c18	2	.\" All rights reserved.
79ff4b9e	3	.\"
3177b9af	4	.\" %sccs.include.redist.man%
79ff4b9e	5	.\"
0fccfdb8	6	.\" @(#)halt.8 6.5 (Berkeley) %G%
5bcf4c18	7	.\"
0fccfdb8 CL	8	.Dd
	9	.Dt HALT 8
	10	.Os BSD 4
	11	.Sh NAME
	12	.Nm halt
	13	.Nd stop the processor
	14	.Sh SYNOPSIS
	15	.Nm halt
	16	.Op Fl n
	17	.Op Fl q
	18	.Op Fl y
	19	.Sh DESCRIPTION
	20	.Nm Halt
79ff4b9e KM	21	writes out sandbagged information to the disks and then stops
	22	the processor. The machine does not reboot, even if the auto-reboot
	23	switch is set on the console.
0fccfdb8 CL	24	.Pp
	25	Available options for
	26	.Nm halt :
	27	.Bl -tag -width Ds
	28	.It Fl n
	29	No sync before stopping.
	30	.It Fl q
	31	Quick halt, no graceful shutdown is attempted.
	32	.It Fl y
	33	This option is needed if you are trying to halt the system from a dialup.
	34	.El
	35	.Pp
	36	.Nm Halt
b77763cc	37	normally logs the shutdown using
0fccfdb8	38	.Xr syslog 8
b77763cc	39	and places a shutdown record in the login accounting file
0fccfdb8	40	.Pa /var/log/wtmp.
b77763cc	41	These actions are inhibited if the
0fccfdb8	42	.Fl n
b77763cc	43	or
0fccfdb8	44	.Fl q
b77763cc	45	options are present.
0fccfdb8 CL	46	.Sh SEE ALSO
	47	.Xr reboot 8 ,
	48	.Xr shutdown 8 ,
	49	.Xr syslogd 8
	50	.Sh BUGS
	51	It is very difficult to halt a
	52	.Tn VAX ,
	53	as the machine wants to then
79ff4b9e	54	reboot itself. A rather tight loop suffices.
0fccfdb8 CL	55	.Sh HISTORY
	56	The
	57	.Nm
	58	command appeared in
	59	.Bx 4.0 .