diff options
Diffstat (limited to '')
| -rw-r--r-- | templates/man1/flock.1.pot | 502 |
1 files changed, 502 insertions, 0 deletions
diff --git a/templates/man1/flock.1.pot b/templates/man1/flock.1.pot new file mode 100644 index 00000000..cebecd3a --- /dev/null +++ b/templates/man1/flock.1.pot @@ -0,0 +1,502 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2023-08-27 16:57+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" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "FLOCK" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2022-05-11" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "util-linux 2.38.1" +msgstr "" + +#. type: TH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "User Commands" +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "flock - manage locks from shell scripts" +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<flock> [options] I<file>|I<directory> I<command> [I<arguments>]" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<flock> [options] I<file>|I<directory> B<-c> I<command>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<flock> [options] I<number>" +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"This utility manages B<flock>(2) locks from within shell scripts or from the " +"command line." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"The first and second of the above forms wrap the lock around the execution " +"of a I<command>, in a manner similar to B<su>(1) or B<newgrp>(1). They lock " +"a specified I<file> or I<directory>, which is created (assuming appropriate " +"permissions) if it does not already exist. By default, if the lock cannot be " +"immediately acquired, B<flock> waits until the lock is available." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"The third form uses an open file by its file descriptor I<number>. See the " +"examples below for how that can be used." +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "OPTIONS" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-c>, B<--command> I<command>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "Pass a single I<command>, without arguments, to the shell with B<-c>." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-E>, B<--conflict-exit-code> I<number>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"The exit status used when the B<-n> option is in use, and the conflicting " +"lock exists, or the B<-w> option is in use, and the timeout is reached. The " +"default value is B<1>. The I<number> has to be in the range of 0 to 255." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-F>, B<--no-fork>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Do not fork before executing I<command>. Upon execution the flock process is " +"replaced by I<command> which continues to hold the lock. This option is " +"incompatible with B<--close> as there would otherwise be nothing left to " +"hold the lock." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-e>, B<-x>, B<--exclusive>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Obtain an exclusive lock, sometimes called a write lock. This is the default." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-n>, B<--nb>, B<--nonblock>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Fail rather than wait if the lock cannot be immediately acquired. See the B<-" +"E> option for the exit status used." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-o>, B<--close>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Close the file descriptor on which the lock is held before executing " +"I<command>. This is useful if I<command> spawns a child process which should " +"not be holding the lock." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-s>, B<--shared>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "Obtain a shared lock, sometimes called a read lock." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-u>, B<--unlock>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Drop a lock. This is usually not required, since a lock is automatically " +"dropped when the file is closed. However, it may be required in special " +"cases, for example if the enclosed command group may have forked a " +"background process which should not be holding the lock." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-w>, B<--wait>, B<--timeout> I<seconds>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Fail if the lock cannot be acquired within I<seconds>. Decimal fractional " +"values are allowed. See the B<-E> option for the exit status used. The zero " +"number of I<seconds> is interpreted as B<--nonblock>." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<--verbose>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Report how long it took to acquire the lock, or why the lock could not be " +"obtained." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-h>, B<--help>" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "Display help text and exit." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<-V>, B<--version>" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "Print version and exit." +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "EXIT STATUS" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"The command uses E<lt>sysexits.hE<gt> exit status values for everything, " +"except when using either of the options B<-n> or B<-w> which report a " +"failure to acquire the lock with an exit status given by the B<-E> option, " +"or 1 by default. The exit status given by B<-E> has to be in the range of 0 " +"to 255." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"When using the I<command> variant, and executing the child worked, then the " +"exit status is that of the child command." +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<flock> does not detect deadlock. See B<flock>(2) for details." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Some file systems (e. g. NFS and CIFS) have a limited implementation of " +"B<flock>(2) and flock may always fail. For details see B<flock>(2), " +"B<nfs>(5) and B<mount.cifs>(8). Depending on mount options, flock can always " +"fail there." +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "Note that \"shellE<gt> \" in examples is a command line prompt." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"shell1E<gt> flock /tmp -c cat; shell2E<gt> flock -w .007 /tmp -c echo; /bin/" +"echo $?" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"Set exclusive lock to directory I</tmp> and the second command will fail." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"shell1E<gt> flock -s /tmp -c cat; shell2E<gt> flock -s -w .007 /tmp -c " +"echo; /bin/echo $?" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"Set shared lock to directory I</tmp> and the second command will not fail. " +"Notice that attempting to get exclusive lock with second command would fail." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "shellE<gt> flock -x local-lock-file echo \\(aqa b c\\(aq" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Grab the exclusive lock \"local-lock-file\" before running echo with \\(aqa " +"b c\\(aq." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"(; flock -n 9 || exit 1; # ... commands executed under lock ...; ) 9E<gt>/" +"var/lock/mylockfile" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"The form is convenient inside shell scripts. The mode used to open the file " +"doesn\\(cqt matter to B<flock>; using I<E<gt>> or I<E<gt>E<gt>> allows the " +"lockfile to be created if it does not already exist, however, write " +"permission is required. Using I<E<lt>> requires that the file already exists " +"but only read permission is required." +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"[ \"${FLOCKER}\" != \"$0\" ] && exec env FLOCKER=\"$0\" flock -en \"$0\" " +"\"$0\" \"$@\" || :" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"This is useful boilerplate code for shell scripts. Put it at the top of the " +"shell script you want to lock and it\\(cqll automatically lock itself on the " +"first run. If the environment variable B<$FLOCKER> is not set to the shell " +"script that is being run, then execute B<flock> and grab an exclusive non-" +"blocking lock (using the script itself as the lock file) before re-execing " +"itself with the right arguments. It also sets the B<FLOCKER> environment " +"variable to the right value so it doesn\\(cqt run again." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "shellE<gt> exec 4E<lt>E<gt>/var/lock/mylockfile; shellE<gt> flock -n 4" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"This form is convenient for locking a file without spawning a subprocess. " +"The shell opens the lock file for reading and writing as file descriptor 4, " +"then B<flock> is used to lock the descriptor." +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "AUTHORS" +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "COPYRIGHT" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"Copyright © 2003-2006 H. Peter Anvin. This is free software; see the source " +"for copying conditions. There is NO warranty; not even for MERCHANTABILITY " +"or FITNESS FOR A PARTICULAR PURPOSE." +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "B<flock>(2)" +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "REPORTING BUGS" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "For bug reports, use the issue tracker at" +msgstr "" + +#. type: SH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "AVAILABILITY" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +msgid "" +"The B<flock> command is part of the util-linux package which can be " +"downloaded from" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2022-02-14" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "util-linux 2.37.4" +msgstr "" + +#. type: Plain text +#: opensuse-leap-15-6 +msgid "Display version information and exit." +msgstr "" + +#. type: Plain text +#: opensuse-leap-15-6 +msgid "Set exclusive lock to directory /tmp and the second command will fail." +msgstr "" + +#. type: Plain text +#: opensuse-leap-15-6 +msgid "" +"Set shared lock to directory /tmp and the second command will not fail. " +"Notice that attempting to get exclusive lock with second command would fail." +msgstr "" + +#. type: Plain text +#: opensuse-leap-15-6 +msgid "[ ${FLOCKER} != $0 ] && exec env FLOCKER=\"$0 flock -en $0 $0 $@ ||" +msgstr "" + +#. type: Plain text +#: opensuse-leap-15-6 +msgid "" +"This is useful boilerplate code for shell scripts. Put it at the top of the " +"shell script you want to lock and it\\(cqll automatically lock itself on the " +"first run. If the env var B<$FLOCKER> is not set to the shell script that is " +"being run, then execute B<flock> and grab an exclusive non-blocking lock " +"(using the script itself as the lock file) before re-execing itself with the " +"right arguments. It also sets the FLOCKER env var to the right value so it " +"doesn\\(cqt run again." +msgstr "" + +#. type: Plain text +#: opensuse-leap-15-6 +msgid "" +"This form is convenient for locking a file without spawning a subprocess. " +"The shell opens the lock file for reading and writing as file descriptor 4, " +"then flock is used to lock the descriptor." +msgstr "" |