update man page
This commit is contained in:
parent
cb7e71989b
commit
8c65fec8f5
33
dj/dj.1
33
dj/dj.1
@ -7,7 +7,7 @@ dj \(en disk jockey
|
||||
.SH SYNOPSIS
|
||||
|
||||
dj
|
||||
.RB ( -AfHqQ )
|
||||
.RB ( -AdHnq )
|
||||
.RB ( -a
|
||||
.RB [ byte ])
|
||||
.RB ( -c
|
||||
@ -79,20 +79,23 @@ continue reading until a partial or empty read.
|
||||
.PP
|
||||
On a partial or empty read, dj prints a diagnostic message (unless the
|
||||
.B -q
|
||||
or
|
||||
.B -Q
|
||||
options are specified) and exits (unless the
|
||||
.B -f
|
||||
option is specified) and exits (unless the
|
||||
.B -n
|
||||
option is specified, in which case only two consecutive empty reads will cause
|
||||
dj to exit).
|
||||
At exit, usage statistics are printed unless the option
|
||||
.B -Q
|
||||
is specified. The
|
||||
.B -q
|
||||
is specified a second time. The
|
||||
.B -H
|
||||
option will make these diagnostics human-readable.
|
||||
|
||||
.SH DIAGNOSTICS
|
||||
|
||||
The
|
||||
.B -d
|
||||
option prints all information, user-specified or otherwise, before program
|
||||
execution.
|
||||
.PP
|
||||
When dj exits, by default statistics are printed for input and output to
|
||||
standard error in the following format:
|
||||
.PP
|
||||
@ -105,20 +108,14 @@ If the
|
||||
.B -H
|
||||
option is specified dj instead uses this following format:
|
||||
.PP
|
||||
.R {records read} + {partial records read} > {records written}
|
||||
.R + {partial records written} ; {bytes read} > {bytes written}
|
||||
.R {records read} '+' {partial records read} '>' {records written}
|
||||
.R '+' {partial records written} ';' {bytes read} '>' {bytes written}
|
||||
.R {ASCII line feed}
|
||||
.PP
|
||||
The
|
||||
.B -Q
|
||||
option suppresses this output entirely.
|
||||
.PP
|
||||
The
|
||||
.B -q
|
||||
and
|
||||
.B -Q
|
||||
options suppress error messages which print when a read or write is partial or
|
||||
empty.
|
||||
option suppresses error messages which print when a read or write is partial or
|
||||
empty and when used twice suppresses diagnostic output entirely.
|
||||
.PP
|
||||
In non-recoverable errors that don't pertain to dj's read-write cycle, a
|
||||
diagnostic message is printed and dj exits with the appropriate sysexits(3)
|
||||
@ -127,7 +124,7 @@ status.
|
||||
.SH BUGS
|
||||
|
||||
If
|
||||
.B -f
|
||||
.B -n
|
||||
is specified along with a specified count, actual byte output may be lower than
|
||||
expected (the product of the count multiplied by the input block size). If the
|
||||
.B -a
|
||||
|
Loading…
Reference in New Issue
Block a user