sync.8: Page deleted

This page documents the sync command, which is provided by
coreutils. As such, the presence of this page in man-pages
makes no sense. And, anyway, the coreutils project has its
own sync(1) man page and "info" documentation. Furthermore,
the  man-pages sync(8) has crufty out-of-date and to some
extent irrelevant information.  So, now it's gone.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-03-10 15:20:05 +01:00
parent daecb330df
commit fcea836046
1 changed files with 0 additions and 93 deletions

View File

@ -1,93 +0,0 @@
.\" Reboot/halt and Linux information extracted from Rick Faith's original
.\" sync(8) manpage, dating back to the Linux 0.99 days. The Linux-specific
.\" information is attributed to Linus Torvalds
.\" Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
.\"
.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" May be distributed under the GNU General Public License
.\" %%%LICENSE_END
.\"
.TH SYNC 8 1998-11-01 "GNU" "Linux Programmer's Manual"
.SH NAME
sync \- synchronize data on disk with memory
.SH SYNOPSIS
.B "sync [\-\-help] [\-\-version]"
.SH DESCRIPTION
.B sync
writes any data buffered in memory out to disk.
This can include (but is not limited to) modified superblocks,
modified inodes, and delayed reads and writes.
This must be implemented by the kernel;
The
.B sync
program does nothing but exercise the
.BR sync (2)
system call.
.PP
The kernel keeps data in memory to avoid doing (relatively slow) disk
reads and writes.
This improves performance, but if the computer
crashes, data may be lost or the filesystem corrupted as a result.
.B sync
ensures that everything in memory is written to disk.
.PP
.B sync
should be called before the processor is halted in an unusual manner
(e.g., before causing a kernel panic when debugging new kernel code).
In general, the processor should be halted using the
.BR shutdown (8)
or
.BR reboot (8)
or
.BR halt (8)
commands, which will attempt to put the system in a quiescent state
before calling
.BR sync (2).
(Various implementations of these commands exist; consult your
documentation; on some systems one should not call
.BR reboot (8)
and
.BR halt (8)
directly.)
.SH OPTIONS
.TP
.B "\-\-help"
Print a usage message on standard output and exit successfully.
.TP
.B "\-\-version"
Print version information on standard output, then exit successfully.
.TP
.B "\-\-"
Terminate option list.
.SH ENVIRONMENT
The variables
.BR LANG ,
.BR LC_ALL ,
.BR LC_CTYPE ,
and
.B LC_MESSAGES
have the usual meaning.
.SH CONFORMING TO
POSIX.2.
.SH NOTES
On Linux,
.B sync
is guaranteed only to schedule the dirty blocks for writing; it can
actually take a short time before all the blocks are finally written.
The
.BR reboot (8)
and
.BR halt (8)
commands take this into account by sleeping for a few seconds after
calling
.BR sync (2).
.PP
This page describes
.B sync
as found in the file\%utils-4.0 package;
other versions may differ slightly.
.SH SEE ALSO
.BR sync (2),
.BR halt (8),
.BR reboot (8),
.BR update (8)