Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SYNC(1)				  Korn Shell			       SYNC(1)

NAME
       sync - schedule file/file system	updates

SYNOPSIS
       sync [flags]

DESCRIPTION
       sync  transfers buffered	modifications of file metadata and data	to the
       storage device for a specific  file,  a	specific  filesystem,  or  all
       filesystems.

       At  minimum  sync (with no options) should be called before halting the
       system. Most systems provide graceful shutdown procedures that  include
       sync -- use them	if possible.

FLAGS
       -f, --sfsync
	      Calls sfsync(3) to flush all buffered sfio stream	data.

       -s, --fsync=*fd*
	      Calls fsync(2) using the open file descriptor fd to transfer all
	      data associated with fd to the storage device. sync waits	 until
	      the transfer completes or	an error is detected.

       -S, --syncfs=*fd*
	      Calls  syncfs(2)	using  the open	file descriptor	fd to transfer
	      all data for the file system containing the file referred	to  by
	      fd.  Depending  on the native system implementation sync may re-
	      turn before the data is actually written.	Implies	--sfsync.

       -X, --sync, --all
	      Calls sync(2) to transfer	all data for all filesystems.  Depend-
	      ing  on  the  native system implementation the writing, although
	      scheduled, is not	necessarily complete upon  return  from	 sync.
	      Since sync(2) has	no failure indication, sync only fails for op-
	      tion/operand syntax errors, or when sync(2) does not return,  in
	      which  case sync(1) also does not	return.	Implies	--sfsync. This
	      is the default when no options are specified.

SEE ALSO
       fsync(2), sync(2), syncfs(2), sfsync(3),	shutdown(8)

AUTHOR
       David J.	Korn, et. al.

COPYRIGHT
       2019, David J. Korn, et.al.

				 Oct 03, 2019			       SYNC(1)

NAME | SYNOPSIS | DESCRIPTION | FLAGS | SEE ALSO | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=sync&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help