adam/vim
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

runtime(doc): regenerate xxd manpage

Browse Source 
Commit f6fc255e8d (v9.0.1834) updated xxd.1 but the xxd.man
page wasn't re-generated. So let's just regenerate it now.

Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Christian Brabandt
2023-09-27 23:33:39 +02:00
parent 9eb1ce5315
commit e845b38dab
1 changed files with 64 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
runtime/doc/xxd.man
View File

@ -30,19 +30,19 @@ OPTIONS
notation. Thus -c8, -c 8, -c 010 and -cols 8 are all equivalent. notation. Thus -c8, -c 8, -c 010 and -cols 8 are all equivalent.
-a | -autoskip -a | -autoskip
Toggle autoskip: A single '*' replaces nul-lines. Default off. Toggle autoskip: A single '*' replaces NUL-lines. Default off.
-b | -bits -b | -bits
Switch to bits (binary digits) dump, rather than hex dump. This Switch to bits (binary digits) dump, rather than hex dump. This
option writes octets as eight digits "1"s and "0"s instead of a option writes octets as eight digits "1"s and "0"s instead of a
normal hexadecimal dump. Each line is preceded by a line number normal hexadecimal dump. Each line is preceded by a line number
in hexadecimal and followed by an ascii (or ebcdic) representa‐ in hexadecimal and followed by an ASCII (or EBCDIC) representa‐
tion. The command line switches -r, -p, -i do not work with this tion. The command line switches -r, -p, -i do not work with this
mode. mode.
-c cols | -cols cols -c cols | -cols cols
Format <cols> octets per line. Default 16 (-i: 12, -ps: 30, -b: Format <cols> octets per line. Default 16 (-i: 12, -ps: 30, -b:
6). Max 256. No maxmimum for -ps. With -ps, 0 results in one 6). Max 256. No maximum for -ps. With -ps, 0 results in one
long line of output. long line of output.
-C | -capitalize -C | -capitalize
@ -54,18 +54,19 @@ OPTIONS
to EBCDIC. This does not change the hexadecimal representation. to EBCDIC. This does not change the hexadecimal representation.
The option is meaningless in combinations with -r, -p or -i. The option is meaningless in combinations with -r, -p or -i.
-e Switch to little-endian hexdump. This option treats byte groups -e Switch to little-endian hex dump. This option treats byte
as words in little-endian byte order. The default grouping of 4 groups as words in little-endian byte order. The default group‐
bytes may be changed using -g. This option only applies to hex‐ ing of 4 bytes may be changed using -g. This option only ap‐
dump, leaving the ASCII (or EBCDIC) representation unchanged. plies to the hex dump, leaving the ASCII (or EBCDIC) representa‐
The command line switches -r, -p, -i do not work with this mode. tion unchanged. The command line switches -r, -p, -i do not
work with this mode.
-g bytes | -groupsize bytes -g bytes | -groupsize bytes
Separate the output of every <bytes> bytes (two hex characters Separate the output of every <bytes> bytes (two hex characters
or eight bit-digits each) by a whitespace. Specify -g 0 to sup‐ or eight bit digits each) by a whitespace. Specify -g 0 to sup‐
press grouping. <Bytes> defaults to 2 in normal mode, 4 in lit‐ press grouping. <Bytes> defaults to 2 in normal mode, 4 in lit‐
tle-endian mode and 1 in bits mode. Grouping does not apply to tle-endian mode and 1 in bits mode. Grouping does not apply to
postscript or include style. PostScript or include style.
-h | -help -h | -help
Print a summary of available commands and exit. No hex dumping Print a summary of available commands and exit. No hex dumping
@ -87,7 +88,7 @@ OPTIONS
Add <offset> to the displayed file position. Add <offset> to the displayed file position.
-p | -ps | -postscript | -plain -p | -ps | -postscript | -plain
Output in postscript continuous hexdump style. Also known as Output in PostScript continuous hex dump style. Also known as
plain hex dump style. plain hex dump style.
-r | -revert -r | -revert
@ -95,9 +96,15 @@ OPTIONS
not writing to stdout, xxd writes into its output file without not writing to stdout, xxd writes into its output file without
truncating it. Use the combination -r -p to read plain hexadeci‐ truncating it. Use the combination -r -p to read plain hexadeci‐
mal dumps without line number information and without a particu‐ mal dumps without line number information and without a particu‐
lar column layout. Additional Whitespace and line-breaks are al‐ lar column layout. Additional whitespace and line breaks are al‐
lowed anywhere. lowed anywhere.
-R when
In output the hex-value and the value are both colored with the
same color depending on the hex-value. Mostly helping to differ‐
entiate printable and non-printable characters. when is never,
always, or auto.
-seek offset -seek offset
When used after -r: revert with <offset> added to file positions When used after -r: revert with <offset> added to file positions
found in hex dump. found in hex dump.
@ -110,28 +117,27 @@ OPTIONS
(or if combined with +: before the current stdin file position). (or if combined with +: before the current stdin file position).
Without -s option, xxd starts at the current file position. Without -s option, xxd starts at the current file position.
-u Use upper case hex letters. Default is lower case. -u Use upper-case hex letters. Default is lower-case.
-v | -version -v | -version
Show version string. Show version string.
CAVEATS CAVEATS
xxd -r has some builtin magic while evaluating line number information. xxd -r has some built-in magic while evaluating line number informa‐
If the output file is seekable, then the linenumbers at the start of tion. If the output file is seekable, then the line numbers at the
each hexdump line may be out of order, lines may be missing, or over‐ start of each hex dump line may be out of order, lines may be missing,
lapping. In these cases xxd will lseek(2) to the next position. If the or overlapping. In these cases xxd will lseek(2) to the next position.
output file is not seekable, only gaps are allowed, which will be If the output file is not seekable, only gaps are allowed, which will
filled by null-bytes. be filled by null-bytes.
xxd -r never generates parse errors. Garbage is silently skipped. xxd -r never generates parse errors. Garbage is silently skipped.
When editing hex dumps, please note that xxd -r skips everything on the When editing hex dumps, please note that xxd -r skips everything on the
input line after reading enough columns of hexadecimal data (see option input line after reading enough columns of hexadecimal data (see option
-c). This also means, that changes to the printable ascii (or ebcdic) -c). This also means that changes to the printable ASCII (or EBCDIC)
columns are always ignored. Reverting a plain (or postscript) style columns are always ignored. Reverting a plain (or PostScript) style hex
hexdump with xxd -r -p does not depend on the correct number of col‐ dump with xxd -r -p does not depend on the correct number of columns.
umns. Here anything that looks like a pair of hex-digits is inter‐ Here, anything that looks like a pair of hex digits is interpreted.
preted.
Note the difference between Note the difference between
% xxd -i file % xxd -i file
@ -142,7 +148,7 @@ CAVEATS
"rewind" input. A '+' makes a difference if the input source is stdin, "rewind" input. A '+' makes a difference if the input source is stdin,
and if stdin's file position is not at the start of the file by the and if stdin's file position is not at the start of the file by the
time xxd is started and given its input. The following examples may time xxd is started and given its input. The following examples may
help to clarify (or further confuse!)... help to clarify (or further confuse!):
Rewind stdin before reading; needed because the `cat' has already read Rewind stdin before reading; needed because the `cat' has already read
to the end of stdin. to the end of stdin.
@ -154,7 +160,7 @@ CAVEATS
% sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +128 > hex_snippet" % sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +128 > hex_snippet"
< file < file
Hexdump from file position 0x100 ( = 1024-768) on. Hex dump from file position 0x100 (=1024-768) onwards.
% sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +-768 > hex_snippet" % sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +-768 > hex_snippet"
< file < file
@ -169,7 +175,7 @@ EXAMPLES
Print 3 lines (hex 0x30 bytes) from the end of file. Print 3 lines (hex 0x30 bytes) from the end of file.
% xxd -s -0x30 file % xxd -s -0x30 file
Print 120 bytes as continuous hexdump with 20 octets per line. Print 120 bytes as a continuous hex dump with 20 octets per line.
% xxd -l 120 -ps -c 20 xxd.1 % xxd -l 120 -ps -c 20 xxd.1
2e54482058584420312022417567757374203139 2e54482058584420312022417567757374203139
39362220224d616e75616c207061676520666f72 39362220224d616e75616c207061676520666f72
@ -218,8 +224,8 @@ EXAMPLES
leading bytes are suppressed. leading bytes are suppressed.
% echo "010000: 41" | xxd -r -s -0x10000 > file % echo "010000: 41" | xxd -r -s -0x10000 > file
Use xxd as a filter within an editor such as vim(1) to hexdump a region Use xxd as a filter within an editor such as vim(1) to hex dump a re‐
marked between `a' and `z'. gion marked between `a' and `z'.
:'a,'z!xxd :'a,'z!xxd
Use xxd as a filter within an editor such as vim(1) to recover a binary Use xxd as a filter within an editor such as vim(1) to recover a binary
@ -254,7 +260,7 @@ SEE ALSO
uuencode(1), uudecode(1), patch(1) uuencode(1), uudecode(1), patch(1)
WARNINGS WARNINGS
The tools weirdness matches its creators brain. Use entirely at your The tool's weirdness matches its creator's brain. Use entirely at your
own risk. Copy files. Trace it. Become a wizard. own risk. Copy files. Trace it. Become a wizard.
VERSION VERSION