diff options
Diffstat (limited to 'stdu.1')
| -rw-r--r-- | stdu.1 | 28 |
1 files changed, 25 insertions, 3 deletions
@@ -1,16 +1,17 @@ -.Dd 2024-04-14 +.Dd 2024-05-31 .Dt STDU 1 .Sh NAME .Nm stdu .Nd monitor amount of data read from stdin .Sh SYNOPSIS .Nm stdu +.Op Fl Fl forward .Op Fl Fl help .Op Fl Fl human-readable .Op Fl Fl multiline .Op Fl Fl precision Ar n .Nm stdu -.Op Fl hm? +.Op Fl hmo? .Op Fl p Ar n .Sh DESCRIPTION .Nm @@ -23,6 +24,9 @@ in chunks) if \fB--precision\fR or \fB--human-readable\fR aren't specified, so specifying them is recommended. .Sh OPTIONS .Bl -tag -width 3n +.It Fl Fl forward | Fl o +Writes data read from STDIN to STDOUT and prints amount of read data +to STDERR instead of STDOUT. .It Fl Fl help | Fl ? Displays a help message. .It Fl Fl human-readable | Fl h @@ -43,9 +47,27 @@ may add trailing zeroes. .Sh EXAMPLES .Nm is useful as a progress bar replacement when transmitting large files. -.Bd -literal +.Bd -literal -offset indent nc -l 1234 | tee backup.tar.gz | stdu -p3 -h .Ed +.Bd -literal -offset indent +cat void-live-x86_64-musl-base.iso | stdu -ho > /dev/sdb1 +.Ed +.Sh CAVEATS +.Bd -literal -offset indent +cat void-live-x86_64-musl-base.iso | sudo tee /dev/sdb1 | stdu -p3 +.Ed + +Is not very informative because +.Nm +probably reads the data faster from +.Xr tee 1 +than /dev/sdb1 does. This is why +.Ar forward +has been implemented. .Sh "SEE ALSO" +.Xr dd 1 .Xr du 1 +.Xr progress 1 +.Xr pv 1 |