new _doprnt doesn't support %[A-Z]
[unix-history] / usr / src / bin / sync / sync.8
index bb8045b..d890516 100644 (file)
@@ -2,28 +2,37 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
-.\"    @(#)sync.8      4.1 (Berkeley) %G%
+.\"    @(#)sync.8      6.2 (Berkeley) %G%
 .\"
 .\"
-.TH SYNC 8 "4/1/81"
+.TH SYNC 8 ""
 .UC 4
 .SH NAME
 sync \- update the super block
 .SH SYNOPSIS
 .UC 4
 .SH NAME
 sync \- update the super block
 .SH SYNOPSIS
-.B sync
+.B /etc/sync
 .SH DESCRIPTION
 .I Sync
 executes the
 .I sync
 system primitive.
 .I 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
+can be called to insure that all disk writes have been completed before the
 processor is halted in a way not suitably done by
 .IR reboot (8)
 or
 .IR halt (8).
 processor is halted in a way not suitably done by
 .IR reboot (8)
 or
 .IR halt (8).
+Generally, it is preferable to use
+.I reboot
+or
+.I 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
+.IR sync .
 .PP
 See
 .IR sync (2)
 for details on the system primitive.
 .SH "SEE ALSO"
 .PP
 See
 .IR sync (2)
 for details on the system primitive.
 .SH "SEE ALSO"
-sync(2), halt(8), reboot(8), update(8)
+sync(2), fsync(2), halt(8), reboot(8), update(8)