stdu.1


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

.Dd 2024-04-14
.Dt STDU 1
.Sh NAME
.Nm stdu
.Nd monitor amount of data read from stdin
.Sh SYNOPSIS
.Nm stdu
.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 p Ar n
.Sh DESCRIPTION
.Nm
reads data from standard input and prints in real time the amount of data
read.
.Nm
always prints the amount of data read as precisely as specified. Thus it
has to read byte by byte (resulting to slow operation compared to reading
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 help | Fl ?
Displays a help message.
.It Fl Fl human-readable | Fl h
Outputs in human-readable format. Uses binary prefixes by default
(Ki, Mi, Gi, ...). SI prefixes (K, M, G, ...) are used instead if
\fB--precision\fR is specified.
.It Fl Fl multiline | Fl m
Output with line breaks.
.Nm
outputs on one line by default.
.It Fl Fl precision Ar n | Fl p Ar n | \fB-p\fIn\fR
Output with
.Ar n
significant digits.
.Nm
may add trailing zeroes.
.El
.Sh EXAMPLES
.Nm
is useful as a progress bar replacement when transmitting large files.
.Bd -literal
nc -l 1234 | tee backup.tar.gz | stdu -p3 -h
.Ed
.Sh "SEE ALSO"
.Xr du 1