Formátumok

Egy formátumstring több formátum egységet tartalmazhat, amiket szóközzel kell elválasztani. Egy formátum egység legfeljebb három elemet tartalmazhat: egy iteráció számot, egy bájt számot, és egy formátumot.

Az iteráció szám egy opcionális pozitív egész szám (integer), ami alapértelmezésben 1. A formátumok az iterációs számszor ismétlődnek.

A bájt szám egy opcionális pozitív egész szám (integer). Ha specifikálva van, akkor a formátum iterációk által értelmezett bájtok számát határozza meg.

Ha meg van adva egy iterációs szám és/vagy egy bájt szám, akkor egy / jelet kell tennni az iterációs szám és/vagy a bájt szám elé az egyértelműség érdekében. A szóközök a / jel előtt, vagy után figyelmen kívül maradnak.

A formátum megadása kötelező és dupla idézőjelek (" ") közé kell tenni. A formátum fprint stílusú formátum stringetként lesz értelmezve (lásd fprintf(3)), a következő kivételekkel:

• A csillag (*) alkalmazható mint mező szélesség vagy pontosság.
• A bájt szám vagy mező pontosság kötelező minden ``s'' konverzió karakterhez (nem úgy mint az fprintf(3) alapértelmezése, ami ez egész stringre mutat, ha a pontosság nincs megadva.)
• A ``h'', ``l'', ``n'', ``p'' és ``q'' konverziós karakterek nem támogatottak.
• A következő C szabványbann leírt egyszeres escape szekvenciák támogatottak:

  NUL	\0
  <alert character>	\a
  <backspace>	\b
  <form-feed>	\f
  <newline>	\n
  <carriage return>	\r
  <tab>	\t
  <vertical tab>	\v

A Hexdump támogatja továbbá a következő kiegészítő konverziós stringeket:

_a[dox]

Megjeleníti a következő bájt bemeneti offsetét, a fájlok összességére vonatkoztatva. A kapcsolódó karakterek d, o, és x határozzák meg a megjelenítés alapját rendre decimális, oktális vagy hexadecimális formában.

_A[dox]

Azonosítja a _a konverziós stringet, kivéve ha az csak egyszer fordul elő, amikor az összes bemenő adatot feldolgozta.

_c

Kimeneti karakterek az alapértelmezett karakterkészletben. A nem nyomtatható karakterek három karakteren jelennek meg, nullával kiegészített oktális formában, kivéve azokat amelyek szabványos escape jelzésekkel ábrázolhatók, (lásd fentebb), ezeket két karakter stringként ábrázolja.

_p

Kimeneti karakterek az alapértelmezett karakterkészletben. A nem nyomtatható karaktereket egyszeres “.” -tal jelöli.

_u

Kimeneti US ASCII karakterek, a vezérlőkarakterek kivételével, amiket a következő kisbetűs nevek jelölnek. A hexa 0xff-nél nagyobb karakterek hexa stringként jelennek meg.

000 nul 001\soh 0022stx 003 etx 004 eot 005enq

006 ack 007\bel 0088bs 009 ht 00A lf 00Bvt

00C ff 00D\cr 00E 00F si 010 dle 011dc1

012 dc2 013\dc3 0144dc4 0151nak 016 syn 017etb

018 can 019\em 01Ac 01C fs 01Dgs

01E rs 01F\us 0FFel

A konverziós karakterek alapértelmezett és támogatott bájt számlálói a következők:

Minden formátum string esetében az értelmezett adatok mennyisége a formátum adatok által külön-külön igényelt adatok összességével egyenlő, ami a bájt számláló iterációinak száma, vagy formátum által megkövetelt több bájt iterációinak száma amennyiben a bájt számláló nincs megadva.

A bemenetet ``blokkokban'' manipulálja, ahol egy blokk a formátumstringek által meghatározott legnagyobb adat mennyisége.

Format strings interpreting less than an input block's worth of data, whose last format unit both interprets some number of bytes and does not have a specified iteration count, have the iteration count incremented until the entire input block has been processed or there is not enough data remaining in the block to satisfy the format string.

If, either as a result of user specification or hexdump modifying the iteration count as described above, an iteration count is greater than one, no trailing whitespace characters are output during the last iteration.

It is an error to specify a byte count as well as multiple conversion characters or strings unless all but one of the conversion characters or strings is _a or _A.

If, as a result of the specification of the -n option or end-of-file being reached, input data only partially satisfies a format string, the input block is zero-padded sufficiently to display all available data (i.e. any format units overlapping the end of data will display some number of the zero bytes).

Further output by such format strings is replaced by an equivalent number of spaces. An equivalent number of spaces is defined as the number of spaces output by an s conversion character with the same field width and precision as the original conversion character or conversion string but with any “+”, “ ”, “#” conversion flag characters removed, and referencing a NULL string.

Ha nincs formátumstring megadva, akkor az alapértelmezett megjelenítés azonos az -x opció megadásával.

A hexdump sikeres végrehajtás esetén 0, hiba esetén >0 értékkel tér vissza.