# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2023-05-03 10:32+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: fedora-rawhide #, no-wrap msgid "PIPESZ" msgstr "" #. type: TH #: fedora-rawhide #, no-wrap msgid "2023-03-23" msgstr "" #. type: TH #: fedora-rawhide #, no-wrap msgid "util-linux 2.39-rc3" msgstr "" #. type: TH #: fedora-rawhide #, no-wrap msgid "User Commands" msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: fedora-rawhide msgid "pipesz - set or examine pipe and FIFO buffer sizes" msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: fedora-rawhide msgid "B [options] [--set I] [--] [I [argument] ...]" msgstr "" #. type: Plain text #: fedora-rawhide msgid "B [options] --get" msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Pipes and FIFOs maintain an internal buffer used to transfer data between " "the read end and the write end. In some cases, the default size of this " "internal buffer may not be appropriate. This program provides facilities to " "set and examine the size of these buffers." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "The B<--set> operation sets pipe buffer sizes. If it is specified, it must " "be specified with an explicit I. Otherwise, it is implied and the size " "is read from B. The kernel may adjust I as " "described in B(2). To determine the actual buffer sizes set, use the " "B<--verbose> option. If neither B<--file> nor B<--fd> are specified, B<--" "set> acts on standard output." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "The B<--set> operation permits an optional I to execute after " "setting the pipe buffer sizes. This command is executed with the adjusted " "pipes." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "The B<--get> operation outputs data in a tabular format. The first column is " "the name of the pipe as passed to B. File descriptors are named as " "\"fd I\". The second column is the size, in bytes, of the pipe\\(cqs " "internal buffer. The third column is the number of unread bytes currently in " "the pipe. The columns are separated by tabs (\\*(Aq\\(rst\\*(Aq, ASCII 09h). " "If B<--verbose> is specified, a descriptive header is also emitted. If " "neither B<--file> nor B<--fd> are specified, B<--get> acts on standard input." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Unless the B<--check> option is specified, B does I exit if it " "encounters an error while manipulating a file or file descriptor. This " "allows B to be used generically without fear of disrupting the " "execution of pipelines should the type of certain files be later changed. " "For minimal disruption, the B<--quiet> option prevents warnings from being " "emitted in these cases." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "The kernel imposes limits on the amount of pipe buffer space unprivileged " "processes can use, though see B below. The kernel will also refuse to " "shrink a pipe buffer if this would cause a loss of buffered data. See " "B(7) for additional details." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "B supports specifying multiple short options consecutively, in the " "usual B(3) fashion. The first non-option argument is interpreted as " "I. If I might begin with \\*(Aq-\\*(Aq, use \\*(Aq--\\*(Aq " "to separate it from arguments to B. In shell scripts, it is good " "practice to use \\*(Aq--\\*(Aq when parameter expansion is involved. " "B itself does not read from standard input and does not write to " "standard output unless B<--get>, B<--help>, or B<--version> are specified." msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "OPTIONS" msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-g>, B<--get>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Report the size of pipe buffers to standard output and exit. As a special " "behavior, if neither B<--file> nor B<--fd> are specified, standard input is " "examined. It is an error to specify this option in combination with B<--set>." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-s>, B<--set> I" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Set the size of the pipe buffers, in bytes. This option may be suffixed by " "I, I, I, I, I, or I to indicate multiples of 1024. " "Fractional values are supported in this case. Additional suffixes are " "supported but are unlikely to be useful. If this option is not specified, a " "default value is used, as described above. If this option is specified " "multiple times, a warning is emitted and only the last-specified I is " "used. As a special behavior, if neither B<--file> nor B<--fd> are specified, " "standard output is adjusted. It is an error to specify this option in " "combination with B<--get>." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-f>, B<--file> I" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Set the buffer size of the FIFO or pipe at I, relative to the current " "working directory. You may specify this option multiple times to affect " "different files, and you may do so in combination with B<--fd>. Generally, " "this option is used with FIFOs, but it will also operate on anonymous pipes " "such as those found in B. Changes to the buffer size of FIFOs " "are not preserved across system restarts." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-n>, B<--fd> I" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Set the buffer size of the pipe or FIFO passed to B as the specified " "file descriptor number. You may specify this option multiple times to affect " "different file descriptors, and you may do so in combination with B<--file>. " "Shorthand options are provided for the common cases of fd 0 (stdin), fd 1 " "(stdout), and fd 2 (stderr). These should suffice in most cases." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-i>, B<--stdin>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "Shorthand for B<--fd 0>." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-o>, B<--stdout>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "Shorthand for B<--fd 1>." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-e>, B<--stderr>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "Shorthand for B<--fd 2>." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-c>, B<--check>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Exit, without executing I, in case of any error while manipulating " "a file or file descriptor. The default behavior if this is not specified is " "to emit a warning to standard error and continue." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-q>, B<--quiet>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Do not diagnose non-fatal errors to standard error. This option does not " "affect the normal output of B<--get>, B<--verbose>, B<--help>, or B<--" "version>." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-v>, B<--verbose>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "If specified with B<--get>, B will emit a descriptive header above " "the table. Otherwise, if specified, B will print the actual buffer " "sizes set by the kernel to standard error." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-h>, B<--help>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "Display help text and exit." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B<-V>, B<--version>" msgstr "" #. type: Plain text #: fedora-rawhide msgid "Print version and exit." msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Plain text #: fedora-rawhide msgid "B B
if=I bs=1M | ..." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Runs B
(1) with an expanded standard output pipe, allowing it to avoid " "context switches when piping around large blocks." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B -s1M -cf I" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Sets the pipe buffer size of a service FIFO to 1,048,576 bytes. If the " "buffer size could not be set, B exits with an error." msgstr "" #. type: Plain text #: fedora-rawhide msgid "B hello | B -g" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Prints the size of pipe used by the shell to pass input to B. Since " "B does not read standard input, it may also report 6 unread bytes in " "the pipe, depending on relative timings." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "B /proc/I/fd -exec B -gqf \\*(Aq{}\\*(Aq \\*(Aq;\\*(Aq" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Prints the size and number of unread bytes of all pipes in use by I. If " "some pipes are routinely full, B might be able to mitigate a " "processing bottleneck." msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Linux supports adjusting the size of pipe buffers since kernel 2.6.35. This " "release also introduced B." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "This program uses B(2) B/B to get and set " "pipe buffer sizes." msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "This program uses B(2) B to report the amount of unread " "data in pipes. If for some reason this fails, the amount of unread data is " "reported as 0." msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "Before Linux 4.9, some bugs affect how certain resource limits are enforced " "when setting pipe buffer sizes. See B(7) for details." msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "AUTHORS" msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: fedora-rawhide msgid "B(7)" msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "REPORTING BUGS" msgstr "" #. type: Plain text #: fedora-rawhide msgid "For bug reports, use the issue tracker at" msgstr "" #. type: SH #: fedora-rawhide #, no-wrap msgid "AVAILABILITY" msgstr "" #. type: Plain text #: fedora-rawhide msgid "" "The B command is part of the util-linux package which can be " "downloaded from" msgstr ""