Movatterモバイル変換

F_GETFL(2const) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ERRORS \|STANDARDS \|HISTORY \|BUGS \|SEE ALSO \|COLOPHON

F_GETFL(2const)F_GETFL(2const)

NAME top

       F_GETFL, F_SETFL - get/set file status flags

LIBRARY top

       Standard C library (libc,-lc)

SYNOPSIS top

#include <fcntl.h>int fcntl(intfd, F_GETFL);int fcntl(intfd, F_SETFL, intarg);

DESCRIPTION top

       Each open file description has certain associated status flags,       initialized byopen(2) and possibly modified byfcntl(2).       Duplicated file descriptors (made withdup(2),F_DUPFD(2const),fork(2), etc.) refer to the same open file description, and thus       share the same file status flags.       The file status flags and their semantics are described inopen(2).F_GETFL              Return (as the function result) the file access mode and              the file status flags;arg is ignored.F_SETFL              Set the file status flags to the value specified byarg.              File access mode (O_RDONLY,O_WRONLY,O_RDWR) and file              creation flags (i.e.,O_CREAT,O_EXCL,O_NOCTTY,O_TRUNC)              inarg are ignored.  On Linux, this operation can change              only theO_APPEND,O_ASYNC,O_DIRECT,O_NOATIME, andO_NONBLOCKflags.  It is not possible to change theO_DSYNC              andO_SYNCflags; see BUGS, below.

RETURN VALUE top

F_GETFL              Value of file status flags.F_SETFL              Zero.       On error, -1 is returned, anderrno is set to indicate the error.

ERRORS top

       Seefcntl(2).EPERMAttempted to clear theO_APPENDflag on a file that has the              append-only attribute set.

STANDARDS top

       POSIX.1-2008.

HISTORY top

       SVr4, 4.3BSD, POSIX.1-2001.

BUGS top

F_SETFL       It is not possible to useF_SETFLto change the state of theO_DSYNCandO_SYNCflags.  Attempts to change the state of these       flags are silently ignored.

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-07-20F_GETFL(2const)

Pages that refer to this page:fcntl(2), F_GETSIG(2const)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface.

For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere.

Hosting byjambit GmbH.