da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin/***********************************************************************
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* This software is part of the ast package *
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner* Copyright (c) 1992-2010 AT&T Intellectual Property *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* and is licensed under the *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* Common Public License, Version 1.0 *
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin* by AT&T Intellectual Property *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* A copy of the License is available at *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* (with md5 checksum 059e8cd6165cb4c31e351f2b69388fd9) *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* Information and Software Systems Research *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* AT&T Research *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* Florham Park NJ *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* Glenn Fowler <gsf@research.att.com> *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin* David Korn <dgk@research.att.com> *
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin***********************************************************************/
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin * David Korn
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin * Glenn Fowler
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin * AT&T Research
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin"[-?\n@(#)$Id: sync (AT&T Research) 2006-10-04 $\n]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin"[+NAME?sync - schedule file system updates]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin"[+DESCRIPTION?\bsync\b calls \bsync\b(2), which causes all information "
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "in memory that updates file systems to be scheduled for writing out to "
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "all file systems. The writing, although scheduled, is not necessarily "
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "complete upon return from \bsync\b.]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin"[+?Since \bsync\b(2) has no failure indication, \bsync\b only fails for "
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "option/operand syntax errors, or when \bsync\b(2) does not return, in "
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "which case \bsync\b also does not return.]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin"[+?At minimum \bsync\b should be called before halting the system. Most "
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "systems provide graceful shutdown procedures that include \bsync\b -- "
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "use them if possible.]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin"[+EXIT STATUS?]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "[+0?\bsync\b(2) returned.]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin "[+>0?Option/operand syntax error.]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin"[+SEE ALSO?\bsync\b(2), \bshutdown\b(8)]"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin error(ERROR_usage(2), "failed -- the native system does not provide a sync(2) call");