mirrors/pv
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Adjust the text relating to splice() in relation to the intermediate pipe development.

Browse Source
This commit is contained in:
Andrew Wood
2026-05-03 18:26:55 +01:00
parent 663a54bda0
commit f3ce23e7c7
2 changed files with 21 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/pv.1
+7 -10
View File
@@ -285,16 +285,16 @@ from or to a pipe than regular \fBread\fR(2) and \fBwrite\fR(2), but means
that the transfer buffer may not be used.
This prevents \*(lq\fB\-\-buffer\-percent\fR\*(rq and
\*(lq\fB\-\-last\-written\fR\*(rq from working, cannot work with
\*(lq\fB\-\-sparse\fR\*(rq or \*(lq\fB\-\-discard\fR\*(rq, and makes
\*(lq\fB\-\-buffer\-size\fR\*(rq redundant, so using any of those options
automatically switches on \*(lq\fB\-\-no\-splice\fR\*(rq.
\*(lq\fB\-\-sparse\fR\*(rq, and makes \*(lq\fB\-\-buffer\-size\fR\*(rq
redundant, so using any of those options automatically switches on
\*(lq\fB\-\-no\-splice\fR\*(rq.
Switching on this option results in a small loss of transfer efficiency.
It has no effect on systems where \fBsplice\fR(2) is unavailable.
.TP
.BI \-J\ BYTES \fR,\ \fB\-\-pipe\-buffer\-size\ BYTES
Attempt to set the size of the output pipe buffer to \fIBYTES\fR bytes.
This will only have an effect if the output is a pipe, and will silently do
nothing if the requested size cannot be achieved.
Attempt to set the size of the output pipe buffer, and the intermediate
input pipe buffer if one is needed, to \fIBYTES\fR bytes.
This will silently do nothing if the requested size cannot be achieved.
If this option is not specified, and both the output and the first input are
pipes, then the output pipe buffer size will automatically be increased to
match the input pipe buffer, if it was smaller.
@@ -369,9 +369,6 @@ This can be useful if you have a pipeline which generates data (your
input) quickly but you don't know the size, and you wish to pass it to some
slower process, once all of the input has been generated and you know its
size, so you can see its progress.
Note that when doing this with relatively small amounts of data,
\*(lq\fB\-\-no-splice\fR\*(rq may be preferable so that pipe buffering
doesn't affect the progress display.
.\"
.\"
.SS "Alternative operating modes"
@@ -754,7 +751,7 @@ the progress display:
.PP
.in +4
.EX
pv \-\-format '%a %p : %L' big.log | processing-script
pv \-\-no\-splice \-\-format '%a %p : %L' big.log | processing-script
.EE
.in
.PP