version 1.12, 2000/11/09 17:52:14 |
version 1.13, 2001/12/30 08:17:32 |
|
|
.\" $OpenBSD$ |
.\" $OpenBSD$ |
.\" Copyright (c) 1989, 1990 The Regents of the University of California. |
.\" $NetBSD: hexdump.1,v 1.14 2001/12/07 14:46:24 bjh21 Exp $ |
.\" All rights reserved. |
|
.\" |
.\" |
|
.\" 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 |
.\" Redistribution and use in source and binary forms, with or without |
.\" modification, are permitted provided that the following conditions |
.\" modification, are permitted provided that the following conditions |
.\" are met: |
.\" are met: |
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
.\" SUCH DAMAGE. |
.\" SUCH DAMAGE. |
.\" |
.\" |
.\" from: @(#)hexdump.1 5.12 (Berkeley) 7/27/91 |
.\" from: @(#)hexdump.1 8.2 (Berkeley) 4/18/94 |
.\" |
.\" |
.Dd July 27, 1991 |
.Dd April 18, 1994 |
.Dt HEXDUMP 1 |
.Dt HEXDUMP 1 |
.Os |
.Os |
.Sh NAME |
.Sh NAME |
|
|
.Nd ascii, decimal, hexadecimal, octal dump |
.Nd ascii, decimal, hexadecimal, octal dump |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm hexdump |
.Nm hexdump |
.Op Fl bcdovx |
.Op Fl bcCdovx |
|
.Bk -words |
.Op Fl e Ar format_string |
.Op Fl e Ar format_string |
|
.Ek |
|
.Bk -words |
.Op Fl f Ar format_file |
.Op Fl f Ar format_file |
|
.Ek |
|
.Bk -words |
.Op Fl n Ar length |
.Op Fl n Ar length |
|
.Ek |
.Bk -words |
.Bk -words |
.Op Fl s Ar offset |
.Op Fl s Ar skip |
.Ek |
.Ek |
.Ar file Op Ar ... |
.Ar file ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
|
|
Display the input offset in hexadecimal, followed by sixteen |
Display the input offset in hexadecimal, followed by sixteen |
space-separated, three column, space-filled, characters of input |
space-separated, three column, space-filled, characters of input |
data per line. |
data per line. |
|
.It Fl C |
|
.Em Canonical hex+ASCII display . |
|
Display the input offset in hexadecimal, followed by sixteen |
|
space-separated, two column, hexadecimal bytes, followed by the |
|
same sixteen bytes in %_p format enclosed in ``|'' characters. |
.It Fl d |
.It Fl d |
.Em Two-byte decimal display . |
.Em Two-byte decimal display . |
Display the input offset in hexadecimal, followed by eight |
Display the input offset in hexadecimal, followed by eight |
|
|
The format is required and must be surrounded by double quote |
The format is required and must be surrounded by double quote |
.Pq \&"\& \&" |
.Pq \&"\& \&" |
marks. |
marks. |
It is interpreted as an fprintf-style format string (see |
It is interpreted as a fprintf-style format string (see |
.Xr fprintf 3 ) , |
.Xr fprintf 3 ) , |
with the |
with the |
following exceptions: |
following exceptions: |
|
|
.It |
.It |
The conversion characters |
The conversion characters |
.Sq h , |
.Sq h , |
|
.Sq l , |
.Sq n , |
.Sq n , |
|
.Sq p , |
and |
and |
.Sq p |
.Sq q |
are not supported. |
are not supported. |
.It |
.It |
The single character escape sequences |
The single character escape sequences |
|
|
.Li \&%d , \&%i , \&%o , |
.Li \&%d , \&%i , \&%o , |
.Li \&%u , \&%X , \&%x |
.Li \&%u , \&%X , \&%x |
.Xc |
.Xc |
Four byte default, one and two byte counts supported. |
Four byte default, one, two, four and eight byte counts supported. |
.It Xo |
.It Xo |
.Li \&%E , \&%e , \&%f , |
.Li \&%E , \&%e , \&%f , |
.Li \&%G , \&%g |
.Li \&%G , \&%g |
|
|
option. |
option. |
.Pp |
.Pp |
.Nm |
.Nm |
exits 0 on success or >0 if an error occurred. |
exits 0 on success and >0 if an error occurred. |
.Sh EXAMPLES |
.Sh EXAMPLES |
Display the input in perusal format: |
Display the input in perusal format: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
|
|
.Ed |
.Ed |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr od 1 |
.Xr od 1 |
.Sh STANDARDS |
|
The |
|
.Nm |
|
utility is expected to be |
|
.St -p1003.2 |
|
compatible. |
|