macro and text revision (-mdoc version 3)
[unix-history] / usr / src / bin / sync / sync.8
CommitLineData
0fccfdb8
CL
1.\" Copyright (c) 1980, 1991 Regents of the University of California.
2.\" All rights reserved.
a15750af 3.\"
0fccfdb8 4.\" %sccs.include.redist.man%
a15750af 5.\"
0fccfdb8
CL
6.\" @(#)sync.8 6.3 (Berkeley) %G%
7.\"
8.Dd
9.Dt SYNC 8
10.Os BSD 4
11.Sh NAME
12.Nm sync
13.Nd synchronize internal filesystem information with that on the disk
14.Sh SYNOPSIS
15.Nm /etc/sync
16.Sh DESCRIPTION
17.Xr Sync
b4cfb2d9 18can be called to insure that all disk writes have been completed before the
a15750af 19processor is halted in a way not suitably done by
0fccfdb8 20.Xr reboot 8
a15750af 21or
0fccfdb8 22.Xr halt 8 .
b4cfb2d9 23Generally, it is preferable to use
0fccfdb8 24.Xr reboot
b4cfb2d9 25or
0fccfdb8 26.Xr halt
b4cfb2d9
MK
27to shut down the system,
28as they may perform additional actions
29such as resynchronizing the hardware clock
30and flushing internal caches before performing a final
0fccfdb8
CL
31.Xr sync .
32.Pp
33.Nm sync
34utilizes the
35.Xr sync 2
36function call.
37.Sh SEE ALSO
38.Xr sync 2 ,
39.Xr fsync 2 ,
40.Xr halt 8 ,
41.Xr reboot 8 ,
42.Xr update 8
43.Sh HISTORY
44A
45.Nm
46command appeared in Version 6 AT&T UNIX.