diff options
Diffstat (limited to 'templates/man2/fcntl.2.pot')
| -rw-r--r-- | templates/man2/fcntl.2.pot | 487 |
1 files changed, 370 insertions, 117 deletions
diff --git a/templates/man2/fcntl.2.pot b/templates/man2/fcntl.2.pot index 7369ea2f..efa0b38f 100644 --- a/templates/man2/fcntl.2.pot +++ b/templates/man2/fcntl.2.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-03-01 16:56+0100\n" +"POT-Creation-Date: 2024-06-01 05:49+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -24,15 +24,15 @@ msgid "fcntl" msgstr "" #. type: TH -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable opensuse-tumbleweed #, no-wrap -msgid "2023-10-31" +msgid "2024-05-02" msgstr "" #. type: TH -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable #, no-wrap -msgid "Linux man-pages 6.06" +msgid "Linux man-pages 6.8" msgstr "" #. type: SH @@ -76,10 +76,9 @@ msgid "B<#include E<lt>fcntl.hE<gt>>\n" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "B<int fcntl(int >I<fd>B<, int >I<cmd>B<, ... /* >I<arg>B< */ );>\n" +msgid "B<int fcntl(int >I<fd>B<, int >I<op>B<, ... /* >I<arg>B< */ );>\n" msgstr "" #. type: SH @@ -90,33 +89,30 @@ msgid "DESCRIPTION" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "B<fcntl>() performs one of the operations described below on the open file " -"descriptor I<fd>. The operation is determined by I<cmd>." +"descriptor I<fd>. The operation is determined by I<op>." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "B<fcntl>() can take an optional third argument. Whether or not this " -"argument is required is determined by I<cmd>. The required argument type is " -"indicated in parentheses after each I<cmd> name (in most cases, the required " +"argument is required is determined by I<op>. The required argument type is " +"indicated in parentheses after each I<op> name (in most cases, the required " "type is I<int>, and we identify the argument using the name I<arg>), or " "I<void> is specified if the argument is not required." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Certain of the operations below are supported only since a particular Linux " "kernel version. The preferred method of checking whether the host kernel " "supports a particular operation is to invoke B<fcntl>() with the desired " -"I<cmd> value and then test whether the call failed with B<EINVAL>, " -"indicating that the kernel does not recognize this value." +"I<op> value and then test whether the call failed with B<EINVAL>, indicating " +"that the kernel does not recognize this value." msgstr "" #. type: SS @@ -180,10 +176,9 @@ msgid "File descriptor flags" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"The following commands manipulate the flags associated with a file " +"The following operations manipulate the flags associated with a file " "descriptor. Currently, only one such flag is defined: B<FD_CLOEXEC>, the " "close-on-exec flag. If the B<FD_CLOEXEC> bit is set, the file descriptor " "will automatically be closed during a successful B<execve>(2). (If the " @@ -279,13 +274,12 @@ msgid "B<F_SETFL> (I<int>)" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Set the file status flags to the value specified by I<arg>. File access " "mode (B<O_RDONLY>, B<O_WRONLY>, B<O_RDWR>) and file creation flags (i.e., " "B<O_CREAT>, B<O_EXCL>, B<O_NOCTTY>, B<O_TRUNC>) in I<arg> are ignored. On " -"Linux, this command can change only the B<O_APPEND>, B<O_ASYNC>, " +"Linux, this operation can change only the B<O_APPEND>, B<O_ASYNC>, " "B<O_DIRECT>, B<O_NOATIME>, and B<O_NONBLOCK> flags. It is not possible to " "change the B<O_DSYNC> and B<O_SYNC> flags; see BUGS, below." msgstr "" @@ -632,20 +626,18 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "As with traditional advisory locks, the third argument to B<fcntl>(), " "I<lock>, is a pointer to an I<flock> structure. By contrast with " "traditional record locks, the I<l_pid> field of that structure must be set " -"to zero when using the commands described below." +"to zero when using the operations described below." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"The commands for working with open file description locks are analogous to " +"The operations for working with open file description locks are analogous to " "those used with traditional locks:" msgstr "" @@ -870,15 +862,15 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "As well as setting the file descriptor owner, one must also enable " "generation of signals on the file descriptor. This is done by using the " -"B<fcntl>() B<F_SETFL> command to set the B<O_ASYNC> file status flag on the " -"file descriptor. Subsequently, a B<SIGIO> signal is sent whenever input or " -"output becomes possible on the file descriptor. The B<fcntl>() B<F_SETSIG> " -"command can be used to obtain delivery of a signal other than B<SIGIO>." +"B<fcntl>() B<F_SETFL> operation to set the B<O_ASYNC> file status flag on " +"the file descriptor. Subsequently, a B<SIGIO> signal is sent whenever input " +"or output becomes possible on the file descriptor. The B<fcntl>() " +"B<F_SETSIG> operation can be used to obtain delivery of a signal other than " +"B<SIGIO>." msgstr "" #. type: Plain text @@ -1289,8 +1281,7 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "When a process (the \"lease breaker\") performs an B<open>(2) or " "B<truncate>(2) that conflicts with a lease established via B<F_SETLEASE>, " @@ -1299,11 +1290,11 @@ msgid "" "should respond to receipt of this signal by doing whatever cleanup is " "required in preparation for the file to be accessed by another process (e." "g., flushing cached buffers) and then either remove or downgrade its lease. " -"A lease is removed by performing an B<F_SETLEASE> command specifying I<arg> " -"as B<F_UNLCK>. If the lease holder currently holds a write lease on the " -"file, and the lease breaker is opening the file for reading, then it is " +"A lease is removed by performing an B<F_SETLEASE> operation specifying " +"I<arg> as B<F_UNLCK>. If the lease holder currently holds a write lease on " +"the file, and the lease breaker is opening the file for reading, then it is " "sufficient for the lease holder to downgrade the lease to a read lease. " -"This is done by performing an B<F_SETLEASE> command specifying I<arg> as " +"This is done by performing an B<F_SETLEASE> operation specifying I<arg> as " "B<F_RDLCK>." msgstr "" @@ -1351,13 +1342,12 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "The default signal used to notify the lease holder is B<SIGIO>, but this can " -"be changed using the B<F_SETSIG> command to B<fcntl>(). If a B<F_SETSIG> " -"command is performed (even one specifying B<SIGIO>), and the signal handler " -"is established using B<SA_SIGINFO>, then the handler will receive a " +"be changed using the B<F_SETSIG> operation to B<fcntl>(). If a B<F_SETSIG> " +"operation is performed (even one specifying B<SIGIO>), and the signal " +"handler is established using B<SA_SIGINFO>, then the handler will receive a " "I<siginfo_t> structure as its second argument, and the I<si_fd> field of " "this argument will hold the file descriptor of the leased file that has been " "accessed by another process. (This is useful if the caller holds leases " @@ -1503,11 +1493,10 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Notification occurs via delivery of a signal. The default signal is " -"B<SIGIO>, but this can be changed using the B<F_SETSIG> command to " +"B<SIGIO>, but this can be changed using the B<F_SETSIG> operation to " "B<fcntl>(). (Note that B<SIGIO> is one of the nonqueuing standard signals; " "switching to the use of a real-time signal means that multiple notifications " "can be queued to the process.) In the latter case, the signal handler " @@ -2103,13 +2092,15 @@ msgid "" msgstr "" #. type: TP -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<F_GETPIPE_SZ>" msgstr "" #. type: TQ -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<F_SETPIPE_SZ>" msgstr "" @@ -2136,10 +2127,9 @@ msgid "" msgstr "" #. type: TP -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "All other commands" +msgid "All other operations" msgstr "" #. type: Plain text @@ -2203,11 +2193,10 @@ msgid "I<fd> is not an open file descriptor" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_SETLK> or B<F_SETLKW> and the file descriptor open mode " -"doesn't match with the type of lock requested." +"I<op> is B<F_SETLK> or B<F_SETLKW> and the file descriptor open mode doesn't " +"match with the type of lock requested." msgstr "" #. type: TP @@ -2218,20 +2207,18 @@ msgid "B<EBUSY>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_SETPIPE_SZ> and the new pipe capacity specified in I<arg> is " +"I<op> is B<F_SETPIPE_SZ> and the new pipe capacity specified in I<arg> is " "smaller than the amount of buffer space currently used to store data in the " "pipe." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_ADD_SEALS>, I<arg> includes B<F_SEAL_WRITE>, and there exists " -"a writable, shared mapping on the file referred to by I<fd>." +"I<op> is B<F_ADD_SEALS>, I<arg> includes B<F_SEAL_WRITE>, and there exists a " +"writable, shared mapping on the file referred to by I<fd>." msgstr "" #. type: TP @@ -2242,10 +2229,9 @@ msgid "B<EDEADLK>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"It was detected that the specified B<F_SETLKW> command would cause a " +"It was detected that the specified B<F_SETLKW> operation would cause a " "deadlock." msgstr "" @@ -2270,18 +2256,16 @@ msgid "B<EINTR>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_SETLKW> or B<F_OFD_SETLKW> and the operation was interrupted " -"by a signal; see B<signal>(7)." +"I<op> is B<F_SETLKW> or B<F_OFD_SETLKW> and the operation was interrupted by " +"a signal; see B<signal>(7)." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_GETLK>, B<F_SETLK>, B<F_OFD_GETLK>, or B<F_OFD_SETLK>, and the " +"I<op> is B<F_GETLK>, B<F_SETLK>, B<F_OFD_GETLK>, or B<F_OFD_SETLK>, and the " "operation was interrupted by a signal before the lock was checked or " "acquired. Most likely when locking a remote file (e.g., locking over NFS), " "but can sometimes happen locally." @@ -2295,45 +2279,39 @@ msgid "B<EINVAL>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed -msgid "The value specified in I<cmd> is not recognized by this kernel." +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "The value specified in I<op> is not recognized by this kernel." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_ADD_SEALS> and I<arg> includes an unrecognized sealing bit." +"I<op> is B<F_ADD_SEALS> and I<arg> includes an unrecognized sealing bit." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_ADD_SEALS> or B<F_GET_SEALS> and the filesystem containing the " +"I<op> is B<F_ADD_SEALS> or B<F_GET_SEALS> and the filesystem containing the " "inode referred to by I<fd> does not support sealing." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_DUPFD> and I<arg> is negative or is greater than the maximum " +"I<op> is B<F_DUPFD> and I<arg> is negative or is greater than the maximum " "allowable value (see the discussion of B<RLIMIT_NOFILE> in B<getrlimit>(2))." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed -msgid "I<cmd> is B<F_SETSIG> and I<arg> is not an allowable signal number." +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "I<op> is B<F_SETSIG> and I<arg> is not an allowable signal number." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_OFD_SETLK>, B<F_OFD_SETLKW>, or B<F_OFD_GETLK>, and I<l_pid> " +"I<op> is B<F_OFD_SETLK>, B<F_OFD_SETLKW>, or B<F_OFD_GETLK>, and I<l_pid> " "was not specified as zero." msgstr "" @@ -2345,10 +2323,9 @@ msgid "B<EMFILE>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_DUPFD> and the per-process limit on the number of open file " +"I<op> is B<F_DUPFD> and the per-process limit on the number of open file " "descriptors has been reached." msgstr "" @@ -2375,10 +2352,9 @@ msgid "B<ENOTDIR>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"B<F_NOTIFY> was specified in I<cmd>, but I<fd> does not refer to a directory." +"B<F_NOTIFY> was specified in I<op>, but I<fd> does not refer to a directory." msgstr "" #. type: TP @@ -2389,10 +2365,9 @@ msgid "B<EPERM>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> is B<F_SETPIPE_SZ> and the soft or hard user pipe limit has been " +"I<op> is B<F_SETPIPE_SZ> and the soft or hard user pipe limit has been " "reached; see B<pipe>(7)." msgstr "" @@ -2405,10 +2380,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<cmd> was B<F_ADD_SEALS>, but I<fd> was not open for writing or the current " +"I<op> was B<F_ADD_SEALS>, but I<fd> was not open for writing or the current " "set of seals on the file already includes B<F_SEAL_SEAL>." msgstr "" @@ -2434,7 +2408,7 @@ msgstr "" #. SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions. #. type: Plain text #. #-#-#-#-# debian-unstable: fcntl.2.pot (PACKAGE VERSION) #-#-#-#-# -#. .PP +#. .P #. SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions. #. type: Plain text #. #-#-#-#-# fedora-40: fcntl.2.pot (PACKAGE VERSION) #-#-#-#-# @@ -2454,7 +2428,7 @@ msgstr "" #. SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions. #. type: Plain text #. #-#-#-#-# opensuse-tumbleweed: fcntl.2.pot (PACKAGE VERSION) #-#-#-#-# -#. .PP +#. .P #. SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions. #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide @@ -2547,14 +2521,13 @@ msgid "File locking" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "The original Linux B<fcntl>() system call was not designed to handle large " "file offsets (in the I<flock> structure). Consequently, an B<fcntl64>() " "system call was added in Linux 2.4. The newer system call employs a " "different structure for file locking, I<flock64>, and corresponding " -"commands, B<F_GETLK64>, B<F_SETLK64>, and B<F_SETLKW64>. However, these " +"operations, B<F_GETLK64>, B<F_SETLK64>, and B<F_SETLKW64>. However, these " "details can be ignored by applications using glibc, whose B<fcntl>() " "wrapper function transparently employs the more recent system call where it " "is available." @@ -2791,12 +2764,255 @@ msgstr "" msgid "Linux man-pages 6.03" msgstr "" +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "B<int fcntl(int >I<fd>B<, int >I<cmd>B<, ... /* >I<arg>B< */ );>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"B<fcntl>() performs one of the operations described below on the open file " +"descriptor I<fd>. The operation is determined by I<cmd>." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"B<fcntl>() can take an optional third argument. Whether or not this " +"argument is required is determined by I<cmd>. The required argument type is " +"indicated in parentheses after each I<cmd> name (in most cases, the required " +"type is I<int>, and we identify the argument using the name I<arg>), or " +"I<void> is specified if the argument is not required." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"Certain of the operations below are supported only since a particular Linux " +"kernel version. The preferred method of checking whether the host kernel " +"supports a particular operation is to invoke B<fcntl>() with the desired " +"I<cmd> value and then test whether the call failed with B<EINVAL>, " +"indicating that the kernel does not recognize this value." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"The following commands manipulate the flags associated with a file " +"descriptor. Currently, only one such flag is defined: B<FD_CLOEXEC>, the " +"close-on-exec flag. If the B<FD_CLOEXEC> bit is set, the file descriptor " +"will automatically be closed during a successful B<execve>(2). (If the " +"B<execve>(2) fails, the file descriptor is left open.) If the " +"B<FD_CLOEXEC> bit is not set, the file descriptor will remain open across an " +"B<execve>(2)." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"Set the file status flags to the value specified by I<arg>. File access " +"mode (B<O_RDONLY>, B<O_WRONLY>, B<O_RDWR>) and file creation flags (i.e., " +"B<O_CREAT>, B<O_EXCL>, B<O_NOCTTY>, B<O_TRUNC>) in I<arg> are ignored. On " +"Linux, this command can change only the B<O_APPEND>, B<O_ASYNC>, " +"B<O_DIRECT>, B<O_NOATIME>, and B<O_NONBLOCK> flags. It is not possible to " +"change the B<O_DSYNC> and B<O_SYNC> flags; see BUGS, below." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"As with traditional advisory locks, the third argument to B<fcntl>(), " +"I<lock>, is a pointer to an I<flock> structure. By contrast with " +"traditional record locks, the I<l_pid> field of that structure must be set " +"to zero when using the commands described below." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"The commands for working with open file description locks are analogous to " +"those used with traditional locks:" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"As well as setting the file descriptor owner, one must also enable " +"generation of signals on the file descriptor. This is done by using the " +"B<fcntl>() B<F_SETFL> command to set the B<O_ASYNC> file status flag on the " +"file descriptor. Subsequently, a B<SIGIO> signal is sent whenever input or " +"output becomes possible on the file descriptor. The B<fcntl>() B<F_SETSIG> " +"command can be used to obtain delivery of a signal other than B<SIGIO>." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"When a process (the \"lease breaker\") performs an B<open>(2) or " +"B<truncate>(2) that conflicts with a lease established via B<F_SETLEASE>, " +"the system call is blocked by the kernel and the kernel notifies the lease " +"holder by sending it a signal (B<SIGIO> by default). The lease holder " +"should respond to receipt of this signal by doing whatever cleanup is " +"required in preparation for the file to be accessed by another process (e." +"g., flushing cached buffers) and then either remove or downgrade its lease. " +"A lease is removed by performing an B<F_SETLEASE> command specifying I<arg> " +"as B<F_UNLCK>. If the lease holder currently holds a write lease on the " +"file, and the lease breaker is opening the file for reading, then it is " +"sufficient for the lease holder to downgrade the lease to a read lease. " +"This is done by performing an B<F_SETLEASE> command specifying I<arg> as " +"B<F_RDLCK>." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"The default signal used to notify the lease holder is B<SIGIO>, but this can " +"be changed using the B<F_SETSIG> command to B<fcntl>(). If a B<F_SETSIG> " +"command is performed (even one specifying B<SIGIO>), and the signal handler " +"is established using B<SA_SIGINFO>, then the handler will receive a " +"I<siginfo_t> structure as its second argument, and the I<si_fd> field of " +"this argument will hold the file descriptor of the leased file that has been " +"accessed by another process. (This is useful if the caller holds leases " +"against multiple files.)" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"Notification occurs via delivery of a signal. The default signal is " +"B<SIGIO>, but this can be changed using the B<F_SETSIG> command to " +"B<fcntl>(). (Note that B<SIGIO> is one of the nonqueuing standard signals; " +"switching to the use of a real-time signal means that multiple notifications " +"can be queued to the process.) In the latter case, the signal handler " +"receives a I<siginfo_t> structure as its second argument (if the handler was " +"established using B<SA_SIGINFO>) and the I<si_fd> field of this structure " +"contains the file descriptor which generated the notification (useful when " +"establishing notification on multiple directories)." +msgstr "" + #. type: TP -#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "B<F_GETPIPE_SZ>, B<F_SETPIPE_SZ>" msgstr "" +#. type: TP +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "All other commands" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_SETLK> or B<F_SETLKW> and the file descriptor open mode " +"doesn't match with the type of lock requested." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_SETPIPE_SZ> and the new pipe capacity specified in I<arg> is " +"smaller than the amount of buffer space currently used to store data in the " +"pipe." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_ADD_SEALS>, I<arg> includes B<F_SEAL_WRITE>, and there exists " +"a writable, shared mapping on the file referred to by I<fd>." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"It was detected that the specified B<F_SETLKW> command would cause a " +"deadlock." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_SETLKW> or B<F_OFD_SETLKW> and the operation was interrupted " +"by a signal; see B<signal>(7)." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_GETLK>, B<F_SETLK>, B<F_OFD_GETLK>, or B<F_OFD_SETLK>, and the " +"operation was interrupted by a signal before the lock was checked or " +"acquired. Most likely when locking a remote file (e.g., locking over NFS), " +"but can sometimes happen locally." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "The value specified in I<cmd> is not recognized by this kernel." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_ADD_SEALS> and I<arg> includes an unrecognized sealing bit." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_ADD_SEALS> or B<F_GET_SEALS> and the filesystem containing the " +"inode referred to by I<fd> does not support sealing." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_DUPFD> and I<arg> is negative or is greater than the maximum " +"allowable value (see the discussion of B<RLIMIT_NOFILE> in B<getrlimit>(2))." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "I<cmd> is B<F_SETSIG> and I<arg> is not an allowable signal number." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_OFD_SETLK>, B<F_OFD_SETLKW>, or B<F_OFD_GETLK>, and I<l_pid> " +"was not specified as zero." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_DUPFD> and the per-process limit on the number of open file " +"descriptors has been reached." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"B<F_NOTIFY> was specified in I<cmd>, but I<fd> does not refer to a directory." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> is B<F_SETPIPE_SZ> and the soft or hard user pipe limit has been " +"reached; see B<pipe>(7)." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<cmd> was B<F_ADD_SEALS>, but I<fd> was not open for writing or the current " +"set of seals on the file already includes B<F_SEAL_SEAL>." +msgstr "" + #. type: Plain text #: debian-bookworm msgid "" @@ -2805,16 +3021,47 @@ msgid "" "are specified in POSIX.1-2001." msgstr "" +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"The original Linux B<fcntl>() system call was not designed to handle large " +"file offsets (in the I<flock> structure). Consequently, an B<fcntl64>() " +"system call was added in Linux 2.4. The newer system call employs a " +"different structure for file locking, I<flock64>, and corresponding " +"commands, B<F_GETLK64>, B<F_SETLK64>, and B<F_SETLKW64>. However, these " +"details can be ignored by applications using glibc, whose B<fcntl>() " +"wrapper function transparently employs the more recent system call where it " +"is available." +msgstr "" + #. type: TH -#: debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: fedora-40 mageia-cauldron #, no-wrap -msgid "2023-03-30" +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: fedora-40 mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: TH +#: fedora-rawhide +#, no-wrap +msgid "2024-03-03" msgstr "" #. type: TH -#: debian-unstable opensuse-tumbleweed +#: fedora-rawhide #, no-wrap -msgid "Linux man-pages 6.05.01" +msgid "Linux man-pages 6.7" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2023-03-30" msgstr "" #. type: TH @@ -2822,3 +3069,9 @@ msgstr "" #, no-wrap msgid "Linux man-pages 6.04" msgstr "" + +#. type: TH +#: opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages (unreleased)" +msgstr "" |