Adding upstream version 9.1.upstream/9.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 169 insertions, 0 deletions

diff --git a/man/od.1 b/man/od.1
new file mode 100644
index 0000000..741b43c
--- /dev/null
+++ b/man/od.1
@@ -0,0 +1,169 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
+.TH OD "1" "April 2022" "GNU coreutils 9.1" "User Commands"
+.SH NAME
+od \- dump files in octal and other formats
+.SH SYNOPSIS
+.B od
+[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
+.br
+.B od
+[\fI\,-abcdfilosx\/\fR]... [\fI\,FILE\/\fR] [[\fI\,+\/\fR]\fI\,OFFSET\/\fR[\fI\,.\/\fR][\fI\,b\/\fR]]
+.br
+.B od
+\fI\,--traditional \/\fR[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] [[\fI\,+\/\fR]\fI\,OFFSET\/\fR[\fI\,.\/\fR][\fI\,b\/\fR] [\fI\,+\/\fR][\fI\,LABEL\/\fR][\fI\,.\/\fR][\fI\,b\/\fR]]
+.SH DESCRIPTION
+.\" Add any additional description here
+.PP
+Write an unambiguous representation, octal bytes by default,
+of FILE to standard output.  With more than one FILE argument,
+concatenate them in the listed order to form the input.
+.PP
+With no FILE, or when FILE is \-, read standard input.
+.PP
+If first and second call formats both apply, the second format is assumed
+if the last operand begins with + or (if there are 2 operands) a digit.
+An OFFSET operand means \fB\-j\fR OFFSET.  LABEL is the pseudo\-address
+at first byte printed, incremented when dump is progressing.
+For OFFSET and LABEL, a 0x or 0X prefix indicates hexadecimal;
+suffixes may be . for octal and b for multiply by 512.
+.PP
+Mandatory arguments to long options are mandatory for short options too.
+.TP
+\fB\-A\fR, \fB\-\-address\-radix\fR=\fI\,RADIX\/\fR
+output format for file offsets; RADIX is one
+of [doxn], for Decimal, Octal, Hex or None
+.TP
+\fB\-\-endian=\fR{big|little}
+swap input bytes according the specified order
+.TP
+\fB\-j\fR, \fB\-\-skip\-bytes\fR=\fI\,BYTES\/\fR
+skip BYTES input bytes first
+.TP
+\fB\-N\fR, \fB\-\-read\-bytes\fR=\fI\,BYTES\/\fR
+limit dump to BYTES input bytes
+.TP
+\fB\-S\fR BYTES, \fB\-\-strings\fR[=\fI\,BYTES\/\fR]
+output strings of at least BYTES graphic chars;
+3 is implied when BYTES is not specified
+.TP
+\fB\-t\fR, \fB\-\-format\fR=\fI\,TYPE\/\fR
+select output format or formats
+.TP
+\fB\-v\fR, \fB\-\-output\-duplicates\fR
+do not use * to mark line suppression
+.TP
+\fB\-w[BYTES]\fR, \fB\-\-width\fR[=\fI\,BYTES\/\fR]
+output BYTES bytes per output line;
+32 is implied when BYTES is not specified
+.TP
+\fB\-\-traditional\fR
+accept arguments in third form above
+.TP
+\fB\-\-help\fR
+display this help and exit
+.TP
+\fB\-\-version\fR
+output version information and exit
+.SS "Traditional format specifications may be intermixed; they accumulate:"
+.TP
+\fB\-a\fR
+same as \fB\-t\fR a,  select named characters, ignoring high\-order bit
+.TP
+\fB\-b\fR
+same as \fB\-t\fR o1, select octal bytes
+.TP
+\fB\-c\fR
+same as \fB\-t\fR c,  select printable characters or backslash escapes
+.TP
+\fB\-d\fR
+same as \fB\-t\fR u2, select unsigned decimal 2\-byte units
+.TP
+\fB\-f\fR
+same as \fB\-t\fR fF, select floats
+.TP
+\fB\-i\fR
+same as \fB\-t\fR dI, select decimal ints
+.TP
+\fB\-l\fR
+same as \fB\-t\fR dL, select decimal longs
+.TP
+\fB\-o\fR
+same as \fB\-t\fR o2, select octal 2\-byte units
+.TP
+\fB\-s\fR
+same as \fB\-t\fR d2, select decimal 2\-byte units
+.TP
+\fB\-x\fR
+same as \fB\-t\fR x2, select hexadecimal 2\-byte units
+.SS "TYPE is made up of one or more of these specifications:"
+.TP
+a
+named character, ignoring high\-order bit
+.TP
+c
+printable character or backslash escape
+.TP
+d[SIZE]
+signed decimal, SIZE bytes per integer
+.TP
+f[SIZE]
+floating point, SIZE bytes per float
+.TP
+o[SIZE]
+octal, SIZE bytes per integer
+.TP
+u[SIZE]
+unsigned decimal, SIZE bytes per integer
+.TP
+x[SIZE]
+hexadecimal, SIZE bytes per integer
+.PP
+SIZE is a number.  For TYPE in [doux], SIZE may also be C for
+sizeof(char), S for sizeof(short), I for sizeof(int) or L for
+sizeof(long).  If TYPE is f, SIZE may also be F for sizeof(float), D
+for sizeof(double) or L for sizeof(long double).
+.PP
+Adding a z suffix to any type displays printable characters at the end of
+each output line.
+.SS "BYTES is hex with 0x or 0X prefix, and may have a multiplier suffix:"
+.TP
+b
+512
+.TP
+KB
+1000
+.TP
+K
+1024
+.TP
+MB
+1000*1000
+.TP
+M
+1024*1024
+.PP
+and so on for G, T, P, E, Z, Y.
+Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
+.SH EXAMPLES
+.TP
+.B od -A x -t x1z -v
+Display hexdump format output
+.TP
+.B od -A o -t oS -w16
+The default output format used by od
+.SH AUTHOR
+Written by Jim Meyering.
+.SH "REPORTING BUGS"
+GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
+.br
+Report any translation bugs to <https://translationproject.org/team/>
+.SH COPYRIGHT
+Copyright \(co 2022 Free Software Foundation, Inc.
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+Full documentation <https://www.gnu.org/software/coreutils/od>
+.br
+or available locally via: info \(aq(coreutils) od invocation\(aq