.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2005, 2008, Michael Kerrisk .\" (A few fragments remain from an earlier (1992) version by .\" Drew Eckhardt .) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified by Michael Haardt .\" Modified 1993-07-23 by Rik Faith .\" Modified 1996-10-22 by Eric S. Raymond .\" Modified 2004-06-17 by Michael Kerrisk .\" Modified 2005, mtk: added an example program .\" Modified 2008-01-09, mtk: rewrote DESCRIPTION; minor additions .\" to EXAMPLE text. .\" 2008-10-10, mtk: add description of pipe2() .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH pipe 2 "30 июля 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ pipe, pipe2 \- создаёт канал .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBint pipe(int \fP\fIpipefd\fP\fB[2]);\fP .PP \fB#define _GNU_SOURCE\fP /* See feature_test_macros(7) */ \fB#include \fP /* Definition of \fBO_*\fP constants */ \fB#include \fP .PP \fBint pipe2(int \fP\fIpipefd\fP\fB[2], int \fP\fIflags\fP\fB);\fP .PP /* On Alpha, IA\-64, MIPS, SuperH, and SPARC/SPARC64, pipe() has the following prototype; see VERSIONS */ .PP \fB#include \fP .PP \fBstruct fd_pair {\fP \fBlong fd[2];\fP \fB};\fP \fBstruct fd_pair pipe(void);\fP .fi .SH ОПИСАНИЕ \fBpipe\fP() создаёт однонаправленный канал данных, который можно использовать для взаимодействия между процессами. Массив \fIpipefd\fP используется для возврата двух файловых описателей, указывающих на концы канала. \fIpipefd[0]\fP указывает на конец канала для чтения. \fIpipefd[1]\fP указывает на конец канала для записи. Данные, записанные в конец канала, буферизируются ядром до тех пор, пока не будут прочитаны из конца канала для чтения. Подробней см. \fBpipe\fP(7). .PP Если \fIflags\fP равно 0, то \fBpipe2\fP() выполняет то же что и \fBpipe\fP(). Следующие значения могут быть побитово сложены в \fIflags\fP для получения различного поведения: .TP \fBO_CLOEXEC\fP Устанавливает флаг close\-on\-exec (\fBFD_CLOEXEC\fP) для двух новых открытых файловых дескрипторов. Смотрите описание того же флага в \fBopen\fP(2) для того, чтобы узнать как это может пригодиться. .TP \fBO_DIRECT\fP (начиная с Linux 3.4) .\" commit 9883035ae7edef3ec62ad215611cb8e17d6a1a5d Создаёт канал, в котором ввод\-вывод выполняется в «пакетном» режиме. Каждый \fBwrite\fP(2) в канал рассматривается как отдельный пакет, а \fBread\fP(2) из канала читает один пакет за раз. Заметим следующее: .RS .IP \[bu] 3 Запись более \fBPIPE_BUF\fP байт (смотрите \fBpipe\fP(7)) будет разделена на несколько пакетов. Константа \fBPIPE_BUF\fP определена в \fI\fP. .IP \[bu] Если в \fBread\fP(2) указан размер буфера меньше чем следующий пакет, то читается запрашиваемое количество байт, а лишние байты пакета отбрасываются. Указание \fBPIPE_BUF\fP в качестве размера буфера будет достаточно для чтения самых больших пакетов (смотрите предыдущее примечание). .IP \[bu] Пакеты нулевой длины не поддерживаются (вызов \fBread\fP(2) с нулевым размером буфера ничего не делает и возвращает 0). .RE .IP Старые ядра, которые не поддерживают этот флаг, возвращают ошибку \fBEINVAL\fP. .IP .\" commit 0dbf5f20652108106cb822ad7662c786baaa03ff .\" FIXME . But, it is not possible to specify O_DIRECT when opening a FIFO Начиная с Linux 4.5, у файлового дескриптора канала возможно менять установку \fBO_DIRECT\fP с помощью \fBfcntl\fP(2). .TP \fBO_NONBLOCK\fP Устанавливает флаг состояния файла \fBO_NONBLOCK\fP для открытого файлового описания, на которое ссылаются новые файловые дескрипторы. Использование данного флага делает ненужными дополнительные вызовы \fBfcntl\fP(2) для достижения того же результата. .TP \fBO_NOTIFICATION_PIPE\fP .\" commit c73be61cede5882f9605a852414db559c0ebedfd Since Linux 5.8, general notification mechanism is built on the top of the pipe where kernel splices notification messages into pipes opened by user space. The owner of the pipe has to tell the kernel which sources of events to watch and filters can also be applied to select which subevents should be placed into the pipe. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" On success, zero is returned. On error, \-1 is returned, \fIerrno\fP is set to indicate the error, and \fIpipefd\fP is left unchanged. .PP .\" http://austingroupbugs.net/view.php?id=467 В Linux (и других системах) \fBpipe\fP() не изменяет \fIpipefd\fP при ошибке. Требование стандартизации этого поведения было добавлено в POSIX.1\-2008 TC2. Системный вызов Linux \fBpipe2\fP() также не изменяет \fIpipefd\fP при ошибке. .SH ОШИБКИ .TP \fBEFAULT\fP \fIpipefd\fP задан некорректно. .TP \fBEINVAL\fP (\fBpipe2\fP()) Некорректное значение \fIflags\fP. .TP \fBEMFILE\fP Было достигнуто ограничение по количеству открытых файловых дескрипторов на процесс. .TP \fBENFILE\fP Достигнуто максимальное количество открытых файлов в системе. .TP \fBENFILE\fP Достигнуто жёсткое пользовательское ограничение на выделение памяти для каналов и вызывающий не имеет дополнительных прав; смотрите \fBpipe\fP(7). .TP \fBENOPKG\fP (\fBpipe2\fP()) \fBO_NOTIFICATION_PIPE\fP was passed in \fIflags\fP and support for notifications (\fBCONFIG_WATCH_QUEUE\fP) is not compiled into the kernel. .SH ВЕРСИИ .\" See http://math-atlas.sourceforge.net/devel/assembly/64.psabi.1.33.ps.Z .\" for example, section 3.2.1 "Registers and the Stack Frame". System V ABI на некоторых архитектурах позволяет использовать более одного регистра для возврата нескольких значений; в нескольких архитектурах (Alpha, IA\-64, MIPS, SuperH и SPARC/SPARC64) использована эта возможность для реализации системного вызова \fBpipe\fP() подобно функциям: вызов не использует параметры и при успешном выполнении возвращает пару файловых дескрипторов как результат. Обёрточная функция glibc \fBpipe\fP() учитывает это. Описание регистров хранения второго файлового дескриптора смотрите в \fBsyscall\fP(2). .SH СТАНДАРТЫ .TP \fBpipe\fP() POSIX.1\-2008. .TP \fBpipe2\fP() Linux. .SH ИСТОРИЯ .TP \fBpipe\fP() POSIX.1\-2001. .TP \fBpipe2\fP() Linux 2.6.27, glibc 2.9. .SH ПРИМЕРЫ .\" fork.2 refers to this example program. Следующая программа создаёт канал, и затем выполняет \fBfork\fP(2) для создания потомка; потомок наследует скопированный набор файловых дескрипторов, которые указывают на тот же канал. После \fBfork\fP(2) каждый процесс закрывает файловые дескрипторы, которые ненужны каналу (см. \fBpipe\fP(7)). Затем родитель записывает строку, переданную в качестве аргумента командной строки, в канал, а потомок читает эту строку из канала по байту за раз, и выводит её на стандартный вывод. .SS "Исходный код программы" .\" SRC BEGIN (pipe.c) .EX #include #include #include #include #include \& int main(int argc, char *argv[]) { int pipefd[2]; char buf; pid_t cpid; \& if (argc != 2) { fprintf(stderr, "Usage: %s \en", argv[0]); exit(EXIT_FAILURE); } \& if (pipe(pipefd) == \-1) { perror("pipe"); exit(EXIT_FAILURE); } \& cpid = fork(); if (cpid == \-1) { perror("fork"); exit(EXIT_FAILURE); } \& if (cpid == 0) { /* Child reads from pipe */ close(pipefd[1]); /* Close unused write end */ \& while (read(pipefd[0], &buf, 1) > 0) write(STDOUT_FILENO, &buf, 1); \& write(STDOUT_FILENO, "\en", 1); close(pipefd[0]); _exit(EXIT_SUCCESS); \& } else { /* Parent writes argv[1] to pipe */ close(pipefd[0]); /* Close unused read end */ write(pipefd[1], argv[1], strlen(argv[1])); close(pipefd[1]); /* Reader will see EOF */ wait(NULL); /* Wait for child */ exit(EXIT_SUCCESS); } } .EE .\" SRC END .SH "СМ. ТАКЖЕ" \fBfork\fP(2), \fBread\fP(2), \fBsocketpair\fP(2), \fBsplice\fP(2), \fBtee\fP(2), \fBvmsplice\fP(2), \fBwrite\fP(2), \fBpopen\fP(3), \fBpipe\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Alexey, Azamat Hackimov , kogamatranslator49 , Kogan, Max Is , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .