.\" Copyright (c) 1989, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#)hexdump.1 8.2 (Berkeley) 4/18/94 .\" .Dd April 18, 1994 .Dt HEXDUMP 1 .Os .Sh NÉV .Nm hexdump .Nd ascii, decimális, hexadecimális, oktális dump .Sh ÁTTEKINTÉS .Nm hexdump .Op Fl bcdovx .Op Fl e Ar format_string .Op Fl f Ar format_file .Op Fl n Ar length .Bk -words .Op Fl s Ar skip .Ek .Ar file ... .Sh LEÍRÁS A hexdump segédprogram egy szűrő, ami megjeleníti a megadott fájlokat vagy a szabványos bemenetet, ha nem adunk meg fájlokat egy a felhasználó által megadott formátumban. .Pp Az opciók a következők: .Bl -tag -width Fl .It Fl b .Em Egybájtos oktális megjelenítő. Minden sor elején megjeleníti a bemeneti offsetet hexadecimálisan, majd ezt követik 16 oszlopban a szóközzel elválasztott három jegyű, nullával kiegészített bemeneti adatbájtok oktális formában. .It Fl c .Em Egybájtos karakteres megjelenítő. Minden sor elején megjeleníti a bemeneti offsetet hexadecimálisan, majd ezt követik 16 oszlopban a szóközzel elválasztott három jegyű, szóközzel kiegészített bemeneti adatbájtok karakteres formában. .It Fl d .Em Kétbájtos decimális megjelenítő. Minden sor elején megjeleníti a bemeneti offsetet hexadecimálisan, majd ezt követik 8 oszlopban a szóközzel elválasztott öt jegyű, nullával kiegészített két bájtos adat egységek előjel nélküli, decimális formában. .It Fl e Ar format_string Egy adatok megjelenítéséhez használt format_string formátum stringet ad meg. .It Fl f Ar format_file Megad egy fájlt, ami egy vagy több új sorral elválasztott formátumu stringet tartalmaz. Az üres sorokat és azokat a sorokat, amelyek első nem szóköz karaktere egy kettőskereszt .Pf ( Cm \&# ) nem veszi figyelembe. .It Fl n Ar length Csak .Ar length bájt hosszú bemenetet vesz figyelembe. .It Fl o .Em Két bájtos oktális megjelenítő. Minden sor elején megjeleníti a bemeneti offsetet hexadecimálisan, majd ezt követik 8 oszlopban a szóközzel elválasztott hatjegyű, nullával kiegészített bemeneti adatok kétbájtos oktális formában. .It Fl s Ar offset Elhagy .Ar offset bájtot a bemenet kezdetéről. Alapértelmezésben az .Ar offset decimális számként értelmezett. Bevezető .Cm 0x vagy .Cm 0X , hatására az .Ar offset hexadecimális számként értelmezett, különben bevezető .Cm 0 hatására az .Ar offset oktális számként értelmezett. A .Cm b , .Cm k , vagy .Cm m karakter hozzáadásával az .Ar offset rendre .Li 512 , .Li 1024 , illetve .Li 1048576 , szorzójaként értelmezett. .It Fl v A .Fl v opció hatására a hexdump minden bemeneti adatot megjelenít. A .Fl v opció nélkül bármely kimeneti sorcsoport, ami azonos lenne a közvetlenül előtte lévő kimeneti sor csoporttal (a bemeneti offsetek kivételével) egy egy csillagból álló sorra cserélődne. .It Fl x .Em Kétbájtos hexadecimális megjelenítő Minden sor elején megjeleníti a bemeneti offsetet hexadecimálisan, majd ezt követik 8 oszlopban a szóközzel elválasztott négyjegyű, nullával kiegészített bemeneti adatok kétbájtos hexadecimális formában. .El .Pp A .Nm hexdump minden bemeneti fájlnál a bemenetről a szabványos kimenetre másol, átalakítva az adatokat az .Fl e és .Fl f opciókban megadott opcióknak megfelelően, abban a sorrendben, amiben azok meg voltak adva. .Ss 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. .Pp 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. .Pp 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. .Pp 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. .Pp 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 .Xr fprintf 3 ) , a következő kivételekkel: .Bl -bullet -offset indent .It A csillag (*) alkalmazható mint mező szélesség vagy pontosság. .It A bájt szám vagy mező pontosság .Em kötelező minden ``s'' konverzió karakterhez (nem úgy mint az .Xr fprintf 3 alapértelmezése, ami ez egész stringre mutat, ha a pontosság nincs megadva.) .It A ``h'', ``l'', ``n'', ``p'' és ``q'' konverziós karakterek nem támogatottak. .It A következő C szabványbann leírt egyszeres escape szekvenciák támogatottak: .Bd -ragged -offset indent -compact .Bl -column .It NUL \e0 .It \ea .It \eb .It \ef .It \en .It \er .It \et .It \ev .El .Ed .El .Pp A Hexdump támogatja továbbá a következő kiegészítő konverziós stringeket: .Bl -tag -width Fl .It Cm \&_a Ns Op Cm dox Megjeleníti a következő bájt bemeneti offsetét, a fájlok összességére vonatkoztatva. A kapcsolódó karakterek .Cm d , .Cm o , és .Cm x határozzák meg a megjelenítés alapját rendre decimális, oktális vagy hexadecimális formában. .It Cm \&_A Ns Op Cm dox Azonosítja a .Cm \&_a konverziós stringet, kivéve ha az csak egyszer fordul elő, amikor az összes bemenő adatot feldolgozta. .It Cm \&_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. .It Cm _p Kimeneti karakterek az alapértelmezett karakterkészletben. A nem nyomtatható karaktereket egyszeres .Dq Cm \&. -tal jelöli. .It Cm _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. .Bl -column \&000_nu \&001_so \&002_st \&003_et \&004_eo .It \&000\ nul\t001\ soh\t002\ stx\t003\ etx\t004\ eot\t005\ enq .It \&006\ ack\t007\ bel\t008\ bs\t009\ ht\t00A\ lf\t00B\ vt .It \&00C\ ff\t00D\ cr\t00E\ so\t00F\ si\t010\ dle\t011\ dc1 .It \&012\ dc2\t013\ dc3\t014\ dc4\t015\ nak\t016\ syn\t017\ etb .It \&018\ can\t019\ em\t01A\ sub\t01B\ esc\t01C\ fs\t01D\ gs .It \&01E\ rs\t01F\ us\t0FF\ del .El .El .Pp A konverziós karakterek alapértelmezett és támogatott bájt számlálói a következők: .Bl -tag -width "Xc,_Xc,_Xc,_Xc,_Xc,_Xc" -offset indent .It Li \&%_c , \&%_p , \&%_u , \&%c Csak egy bájtos számláló. .It Xo .Li \&%d , \&%i , \&%o , .Li \&%u , \&%X , \&%x .Xc Négy bájt alapértelmezett, egy, kettő és négy bájtos számláló támogatott. .It Xo .Li \&%E , \&%e , \&%f , .Li \&%G , \&%g .Xc Nyolc bájtos számláló alapértelmezett, négy bájtos számláló támogatott. .El .Pp 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. .Pp A bemenetet ``blokkokban'' manipulálja, ahol egy blokk a formátumstringek által meghatározott legnagyobb adat mennyisége. .Pp 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. .Pp 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. .Pp 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 .Cm \&_a or .Cm \&_A . .Pp If, as a result of the specification of the .Fl 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). .Pp 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 .Cm s conversion character with the same field width and precision as the original conversion character or conversion string but with any .Dq Li \&+ , .Dq \&\ \& , .Dq Li \&# conversion flag characters removed, and referencing a NULL string. .Pp Ha nincs formátumstring megadva, akkor az alapértelmezett megjelenítés azonos az .Fl x opció megadásával. .Pp A .Nm hexdump sikeres végrehajtás esetén 0, hiba esetén >0 értékkel tér vissza. .Sh PÉLDÁK A bemenetet átolvasás formában jeleníti meg: .Bd -literal -offset indent "%06.6_ao " 12/1 "%3_u " "\et\et" "%_p " "\en" .Ed .Pp Az \-x opció végrehajtása: .Bd -literal -offset indent "%07.7_Ax\en" "%07.7_ax " 8/2 "%04x " "\en" .Ed .Sh LÁSD MÉG .Xr adb 1 .Sh MAGYAR FORDÍTÁS Horneczki Gábor