From 10363565a1708a5a5adb6e6624de0dde6455ded4 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Thu, 25 May 2017 18:22:39 +0200 Subject: Document blind-to-named and blind-from-named MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man/blind-to-named.1 | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 man/blind-to-named.1 (limited to 'man/blind-to-named.1') diff --git a/man/blind-to-named.1 b/man/blind-to-named.1 new file mode 100644 index 0000000..5688a5d --- /dev/null +++ b/man/blind-to-named.1 @@ -0,0 +1,39 @@ +.TH BLIND-TO-NAMED 1 blind +.SH NAME +blind-to-named - Send a file descriptor +.SH SYNOPSIS +.B blind-to-named +[-a] +.I path +.SH DESCRIPTION +.B blind-to-named +create a +.BR unix (7) +socket with the filename +.I path +and sends the stdin file descriptor to the +first process that connects to it. +.SH OPTIONS +.TP +.B -a +Rather than binding to a filename, create and abstract +address, starting with a NUL byte followed by +.I path +and padded with NUL bytes until the end of the address. +.SH RATIONALE +The pipeline construction, in even advanced, shells +are not flexible enough to do all kinds of pipelinings +that are necessary when doing complicated effects with +.BR blind (7). +For example, this is necessary to pipe video into +two processes pipelines using +.BR tee (1) +and then using the end of both pipelines as the in +input to the process, like inverse multiplexing. +.SH SEE ALSO +.BR blind (7), +.BR blind-from-named (1), +.BR tee (1) +.SH AUTHORS +Mattias Andrée +.RI < maandree@kth.se > -- cgit v1.2.3-70-g09d2