manual/gnumaniak/original/man1/sync.1

   1 .\" You may copy, distribute and modify under the terms of the LDP General
   2 .\" Public License as specified in the LICENSE file that comes with the
   3 .\" gnumaniak distribution
   4 .\"
   5 .\" The author kindly requests that no comments regarding the "better"
   6 .\" suitability or up-to-date notices of any info documentation alternative
   7 .\" is added without contacting him first.
   8 .\"
   9 .\" (C) 1998-2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  10 .\"
  11 .\"     sync man page
  12 .\"     man pages are NOT obsolete!
  13 .\"     <ragnar@ragnar-hojland.com>
  14 .TH SYNC 1 "18 June 2002" "GNU fileutils 4.1"
  15 .SH NAME
  16 \fBsync\fR \- synchronize filesystem memory buffers with disk
  17 .SH SYNOPSIS
  18 .BR sync " [" \-\-help "] [" \-\-version ]
  19 .SH DESCRIPTION
  20 .B sync
  21 requests the kernel to flush any filesystem data buffers in memory out to
  22 disk.  This flushing can include (but is not limited to) modified superblocks,
  23 modified inodes, and delayed writes.
  24
  25 The kernel keeps data in memory to avoid doing (relatively slow) disk
  26 reads and writes.  This improves performance, but if the computer
  27 crashes, data may be lost or the filesystem corrupted as a result.
  28 \fBsync\fR ensures everything in memory is written to disk, and should be
  29 called whenever you expect your system to go down in an unusual way in which
  30 shutdown commands such as \fBshutdown\fR(8) and \fBhalt\fR(8) won't be run
  31 (these take care of syncing before halting)
  32
  33 Note that this is \fBmerely\fR a request: \fBsync\fR(1) calls the
  34 \fBsync\fR(2)\fR kernel system call, and the kernel schedules the flushing.
  35 Therefore, the \fBsync\fR command may return before the buffers are
  36 actually flushed.
  37 .SH OPTIONS
  38 .TP
  39 .B "\-\-help"
  40 Print a usage message on standard output and exit successfully.
  41 .TP
  42 .B "\-\-version"
  43 Print version information on standard output then exit successfully.
  44 .SH SEE ALSO
  45 \fBhalt\fR(8), \fBshutdown\fR(8), \fBsync\fR(2)
  46 .SH NOTES
  47 Report bugs to <bug-fileutils@gnu.org>.
  48 .br
  49 Man page by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>