BSD 4_3_Net_2 release

[unix-history] / usr / src / bin / sync / sync.8

diff --git a/usr/src/bin/sync/sync.8 b/usr/src/bin/sync/sync.8
index 87b0184..5932928 100644 (file)
--- a/usr/src/bin/sync/sync.8
+++ b/usr/src/bin/sync/sync.8
@@ -1,29 +1,47 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1991 Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)sync.8      6.1 (Berkeley) %G%
+.\" %sccs.include.redist.roff%

 .\"
 .\"

-.TH SYNC 8 ""
-.UC 4
-.SH NAME
-sync \- update the super block
-.SH SYNOPSIS
-.B /etc/sync
-.SH DESCRIPTION
-.I Sync
-executes the
-.I sync
-system primitive.
-.I Sync
-can be called to insure all disk writes have been completed before the
+.\"    %W% (Berkeley) %G%
+.\"
+.Dd %Q%
+.Dt SYNC 8
+.Os BSD 4
+.Sh NAME
+.Nm sync
+.Nd synchronize internal filesystem information with that on the disk
+.Sh SYNOPSIS
+.Nm sync
+.Sh DESCRIPTION
+.Nm Sync
+can be called to insure that all disk writes have been completed before the

 processor is halted in a way not suitably done by
 processor is halted in a way not suitably done by

-.IR reboot (8)
+.Xr reboot 8
+or
+.Xr halt 8 .
+Generally, it is preferable to use
+.Xr reboot

 or
 or

-.IR halt (8).
-.PP
-See
-.IR sync (2)
-for details on the system primitive.
-.SH "SEE ALSO"
-sync(2), fsync(2), halt(8), reboot(8), update(8)
+.Xr halt
+to shut down the system,
+as they may perform additional actions
+such as resynchronizing the hardware clock
+and flushing internal caches before performing a final
+.Nm sync .
+.Pp
+.Nm Sync
+utilizes the
+.Xr sync 2
+function call.
+.Sh SEE ALSO
+.Xr sync 2 ,
+.Xr fsync 2 ,
+.Xr halt 8 ,
+.Xr reboot 8 ,
+.Xr update 8
+.Sh HISTORY
+A
+.Nm sync
+command appeared in
+.At v6 .