2003-09-04 Joel Sherrill <joel@OARcorp.com>

PR 466/doc
	* io.t: Added sync().

doc/posix_users/ChangeLog

@@ -1,3 +1,8 @@
+2003-09-04	Joel Sherrill <joel@OARcorp.com>
+
+	PR 466/doc
+	* io.t: Added sync().
+
 2003-01-25	Ralf Corsepius <corsepiu@faw.uni-ulm.de>
 
 	* posix_users.texi: Set @setfilename posix_users.info.

doc/posix_users/io.t

@@ -25,6 +25,7 @@ The directives provided by the input and output primitives manager are:
 @item @code{lseek} - Reposition read/write file offset
 @item @code{fsync} - Synchronize file complete in-core state with that on disk
 @item @code{fdatasync} - Synchronize file in-core data with that on disk
+@item @code{sync} - Schedule file system updates
 @item @code{mount} - Mount a file system
 @item @code{unmount} - Unmount file systems
 @item @code{aio_read} - Asynchronous Read
@@ -728,6 +729,42 @@ used to avoid unnecessary inode disk write operations.
 
 NONE
 
+@c
+@c
+@c
+@page
+@subsection sync - Schedule file system updates
+
+@findex sync
+@cindex  synchronize file systems
+
+@subheading CALLING SEQUENCE:
+
+@ifset is-C
+@example
+void sync(void);
+@end example
+@end ifset
+
+@ifset is-Ada
+@end ifset
+
+@subheading STATUS CODES:
+
+NONE
+
+@subheading DESCRIPTION:
+
+The @code{sync} service causes all information in memory that updates
+file systems to be scheduled for writing out to all file systems.
+
+
+@subheading NOTES:
+
+The writing of data to the file systems is only guaranteed to be 
+scheduled upon return.  It is not necessarily complete upon return
+from @code{sync}.
+
 @c
 @c
 @c