[lkml]   [2011]   [Mar]   [14]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
    SubjectRe: [PATCH v3] introduce sys_syncfs to sync a single file system
    On Mon, 14 Mar 2011, Indan Zupancic wrote:
    > Everyone seems to want to add this new syncfs, but it's not even defined
    > what it does. "Same as sync, but only on one fs" is IMHO not good
    > enough, because sync's behaviour is pretty badly documented, and that's
    > a system call.

    How about the man page below? I tried to avoid the somewhat antiquated
    implementation specific terminology in the sync(2) man page.

    I think adding this functionality into sync_file_range(2) is forcing
    unrelated functionality into an existing interface; sync_file_range
    operates on _files_, not an entire file system. With each API addition it
    is more important to make the interface simple and intuitive than to
    minimize the size of our patches. IMO that's why a new syscall is
    preferable to, say, an equivalent ioctl.


    .TH SYNCFS 2 2011-03-13 "Linux" "Linux Programmer's Manual"
    .SH NAME
    syncfs \- commit cached file system state to stable storage
    .B #include <unistd.h>
    .B void syncfs(int fd);
    .BR syncfs ()
    flushes any cached data modifications to the file system containing the
    file referenced by the file descriptor
    .I fd
    to stable storage (usually a disk). This includes the results of any
    file modifications or other file system operations that have completed
    prior to the call to
    .BR syncfs(2).
    This is similar to
    .BR sync(2),
    but will commit changes for only a single file system instead of all
    mounted file systems.
    This function is always successful.
    .SH "SEE ALSO"
    .BR bdflush (2),
    .BR fdatasync (2),
    .BR fsync (2),
    .BR sync (2),
    .BR sync (8),
    .BR update (8)

     \ /
      Last update: 2011-03-14 05:29    [W:0.021 / U:143.144 seconds]
    ©2003-2016 Jasper Spaans. hosted at Digital OceanAdvertise on this site