| Skip Navigation Links | |
| Exit Print View | |
![]() | man pages section 3: Basic Library Functions Oracle Solaris 11 Information Library |
enable_extended_FILE_stdio(3C)
posix_spawnattr_getschedparam(3C)
posix_spawnattr_getschedpolicy(3C)
posix_spawnattr_getsigdefault(3C)
posix_spawnattr_getsigignore_np(3C)
posix_spawnattr_getsigmask(3C)
posix_spawnattr_setschedparam(3C)
posix_spawnattr_setschedpolicy(3C)
posix_spawnattr_setsigdefault(3C)
posix_spawnattr_setsigignore_np(3C)
posix_spawnattr_setsigmask(3C)
posix_spawn_file_actions_addclose(3C)
posix_spawn_file_actions_addclosefrom_np(3C)
posix_spawn_file_actions_adddup2(3C)
posix_spawn_file_actions_addopen(3C)
posix_spawn_file_actions_destroy(3C)
posix_spawn_file_actions_init(3C)
pthread_attr_getdetachstate(3C)
pthread_attr_getinheritsched(3C)
pthread_attr_getschedparam(3C)
pthread_attr_getschedpolicy(3C)
pthread_attr_setdetachstate(3C)
pthread_attr_setinheritsched(3C)
pthread_attr_setschedparam(3C)
pthread_attr_setschedpolicy(3C)
pthread_barrierattr_destroy(3C)
pthread_barrierattr_getpshared(3C)
pthread_barrierattr_setpshared(3C)
pthread_condattr_getpshared(3C)
pthread_condattr_setpshared(3C)
pthread_cond_reltimedwait_np(3C)
pthread_key_create_once_np(3C)
pthread_mutexattr_getprioceiling(3C)
pthread_mutexattr_getprotocol(3C)
pthread_mutexattr_getpshared(3C)
pthread_mutexattr_getrobust(3C)
pthread_mutexattr_setprioceiling(3C)
pthread_mutexattr_setprotocol(3C)
pthread_mutexattr_setpshared(3C)
pthread_mutexattr_setrobust(3C)
pthread_mutex_getprioceiling(3C)
pthread_mutex_reltimedlock_np(3C)
pthread_mutex_setprioceiling(3C)
pthread_rwlockattr_destroy(3C)
pthread_rwlockattr_getpshared(3C)
pthread_rwlockattr_setpshared(3C)
pthread_rwlock_reltimedrdlock_np(3C)
pthread_rwlock_reltimedwrlock_np(3C)
pthread_rwlock_timedrdlock(3C)
pthread_rwlock_timedwrlock(3C)
rctlblk_get_enforced_value(3C)
- synchronize changes to a file
#include <unistd.h>intfsync(intfildes);
Thefsync() function moves all modified data and attributes of the filedescriptorfildes to a storage device. Whenfsync() returns, all in-memory modifiedcopies of buffers associated withfildes have been written to the physical medium.Thefsync() function is different fromsync(), which schedules disk I/O forall files but returns before the I/O completes. Thefsync() functionforces all outstanding data operations to synchronized file integrity completion (seefcntl.h(3HEAD) definitionofO_SYNC.)
Thefsync() function forces all currently queued I/O operations associated with thefile indicated by the file descriptorfildes to the synchronized I/O completionstate. All I/O operations are completed as defined for synchronized I/O fileintegrity completion.
Upon successful completion,0 is returned. Otherwise,-1 is returned anderrnois set to indicate the error. If thefsync() function fails, outstandingI/O operations are not guaranteed to have been completed.
Thefsync() function will fail if:
Thefildes argument is not a valid file descriptor.
A signal was caught during execution of thefsync() function.
An I/O error occurred while reading from or writing to the file system.
There was no free space remaining on the device containing the file.
Remote connection timed out. This occurs when the file is on an NFS file system mounted with thesoft option. Seemount_nfs(1M).
In the event that any of the queued I/O operations fail,fsync()returns the error conditions defined forread(2) andwrite(2).
Thefsync() function should be used by applications that require that afile be in a known state. For example, an application that containsa simple transaction facility might usefsync() to ensure that allchanges to a file or files caused by a given transaction were recordedon a storage medium.
The manner in which the data reach the physical medium depends onboth implementation and hardware. Thefsync() function returns when notified bythe device driver that the write has taken place.
Seeattributes(5) for descriptions of the following attributes:
|
mount_nfs(1M),read(2),sync(2),write(2),fcntl.h(3HEAD),fdatasync(3C),attributes(5),standards(5)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices | ![]() ![]() |