.\" You may copy, distribute and modify under the terms of the LDP General
.\" Public License as specified in the LICENSE file that comes with the
.\" gnumaniak distribution
.\"
.\" The author kindly requests that no comments regarding the "better"
.\" suitability or up-to-date notices of any info documentation alternative
.\" is added without contacting him first.
.\"
.\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
.\"
.\"	GNU od man page
.\"	man pages are NOT obsolete!
.\"	<ragnar@ragnar-hojland.com>
.\"
.\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
.\" Translated Sun 12 Mar 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated & Modified Sat Jan 24 14:55:40 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.TH OD 1 "7 October 2002" "GNU textutils 2.1"
.SH 名前
od \- ファイルを 8 進数 (または他の形式) で出力する
.SH 書式
.B od
.RB [ \-v "] [" "\-j \fIBYTES\fR" "] [" "\-s \fR[\fILENGTH\fR]]"
.RB [ "\-t \fITYPE\fR" "] [" "\-w \fIWIDTH\fR" "] [" "\-A \fIRADIX\fR" ]
.RB [ "\-N \fIBYTES\fR" "]
.RB [ "\-\-address\-radix=\fIRADIX\fR" ] 
.RB [ "\-\-format=\fITYPE\fR" ]
.RB [ \-\-output\-duplicates ]
.RB [ "\-\-read\-bytes=\fIBYTES\fR" ]
.RB [ "\-\-skip\-bytes=\fIBYTES\fR" ]
.RB [ "\-\-strings\fR[\fB=\fILENGTH\fR" ]]
.RB [ "\-\-width\fR[\fB=\fIWIDTH\fR" ]]
.RI [ FILE... ]

.BR od " [" \-\-help "] [" \-\-version ]

非 POSIX オプション:
.br
.B od
.RB [ \-abcdfhilox ]
.RI [ FILE... ]
.br
.IR "\fBod \-C\fR \fR[\fB\-\-traditional" "] [" FILE "] [[\fB+\fR]" OFFSET " [[\fB+\fR]" LABEL ]]
.SH 説明
.B od
は
.I FILE
それぞれの内容を明確な形式で標準出力に書き出す。
.I FILE
が 1 つも与えられないと標準入力から読み込む。また
.I FILE
が
.RB ` \- '
だった場合には、そのファイルには標準入力が用いられる。

出力のそれぞれの行では、
まず最も左のカラムに入力ファイルでのオフセットが書かれ、
ファイルのデータのグループが続く。デフォルトでは
.B od
はオフセットを 8 進数で、ファイルのデータのグループは
2 バイトずつ 8 進数で表す。
.SH オプション
.TP
.B \-j \fIBYTES\fB, \-\-skip\-bytes=\fIBYTES
整形・表示する前に入力ファイルの
.I BYTES
分をスキップする。
.I BYTES
が
.RB ` 0x "' または `" 0X '
で始まる場合は 16 進数と解釈される。これ以外で先頭が
.RB ` 0 '
の場合は 8 進数、それ以外は 10 進数と解釈される。
.RB ` b '
を後置すると
.I BYTES
は 512 倍、
.RB ` k '
なら 1024 倍、
.RB ` m '
なら 1048576 倍される。
.TP
.B \-s \fR[\fILENGTH\fR]\fB, \-\-strings\fR[\fB=\fILENGTH\fR]
通常の出力の代わりに、入力の文字列定数 (string constants) のみを出力する。
文字列定数とは、最低
.I LENGTH
の連続した ASCII グラフィック (フォーマット) 文字で、
null (ゼロ) バイトによって終端されているものである。
.I LENGTH
が省略された場合のデフォルトは 3。
短縮形式 \fB\-s\fR は推奨されない。
.TP
.B \-t \fITYPE\fB, \-\-format=\fITYPE
ファイルデータの出力フォーマットを選択する。
.I TYPE
は文字列で、以下のタイプ指定文字からなる。1 つの
.I TYPE
文字列中に複数のタイプ指定文字を書いたり、このオプションを複数回用いると、
.B od
は指定文字 1 つにつき 1 行の出力行を書き出す。
行の出力順は指定文字の順番になる。

.RB ` z '
を後置すると、どんな形式指定に対しても、
形式指定によって生成された行に
印刷可能文字での ASCII 文字表示を追加する。
.RS
.TP
.B a
文字の名前
.TP
.B c
ASCII 文字かバックスラッシュ付きのエスケープ文字
.TP
.B d
符号付き 10 進数
.TP
.B f
浮動小数点数
.TP
.B o
8 進数
.TP
.B u
符号無し 10 進数
.TP
.B x
16 進数
.PP
.sp
.RB ` a '
形式は空白文字に `sp', 改行文字に `nl', null (ゼロ) バイトに `nul'
等を出力する。`c' ではこれらはそれぞれ ` ', `\en', `\e0' となる。

.RB ` a "' と `" c '
以外のタイプについては、入力データから何バイト分を使うかを指定できる。
これには形式表示文字の後に 10 進の整数を後置する。
または C コンパイラの組み込みデータ型によってもサイズを指定できる。
以下のうちのどれかをタイプ指定の後に指定する。

整数
.RB "(`" d "', `" o "', `" u "', `" x ')
については以下のどれか：
.RS
.TP
.B C
char
.TP
.B S
short
.TP
.B I
int
.TP
.B L
long
.RE
.sp
浮動小数点数
.RB (` f ')
については以下のどれか：
.RS
.TP
.B F
float
.TP
.B D
double
.TP
.B L
long double
.RE
.RE
.TP
.B \-v, \-\-output\-duplicates
直前と同じ内容を持つ行も表示する。
デフォルトでは、連続する出力行が同じ内容である場合には、
.B od
は最初の行のみを表示し、続く行には省略した旨を伝えるアスタリスク (*)
のみを置く。
.TP
.B \-w\fR[\fIWIDTH\fR]\fB, \-\-width\fR[\fB=\fIWIDTH\fR]
出力ファイルの 1 行あたり
.I WIDTH
バイトの入力を表示する。
これは出力タイプに指定した各サイズの公倍数でなければならない。
.I WIDTH
が省略された場合のデフォルトは 32。
このオプションが指定されなかった場合のデフォルトは 16。
短縮形式 \fB\-w\fR は推奨されない。
.TP
.B \-A \fIRADIX\fB, \-\-address\-radix=\fIRADIX
表示されるオフセットの基数を選択する。
.I RADIX
として指定できるのは以下のうちのどれか:
.RS
.TP
.B d
10 進数
.TP
.B o
8 進数 (デフォルト)
.TP
.B x
16 進数
.TP
.B n
なし (オフセットを表示しない)
.RE
.TP
.B \-N \fIBYTES\fB, \-\-read\-bytes=\fIBYTES
入力ファイルのうち
.I BYTES
に達するまでしか表示しない。
.I BYTES
で前置・後置される文字は
.B \-j
オプションと同様に解釈される。
.TP
.B "\-\-help"
標準出力に使用方法のメッセージを出力して正常終了する。
.TP
.B "\-\-version"
標準出力にバージョン情報を出力して正常終了する。
.SH 非 POSIX オプション
.TP
.B \-a
文字の名前を出力する。
.B \-ta
と等価。
.TP
.B \-b
8 進でバイトを出力する。
.B \-toC
と等価。
.TP
.B \-c
ASCII 文字またはバックスラッシュ付きのエスケープ文字として出力する。
.B \-tc
と等価。
.TP
.B \-d
符号無し 10 進 short として出力する。
.B \-tu2
と等価。
.TP
.B \-f
float として出力する。
.B \-tfF
と等価。
.TP
.B \-h
16 進 short として出力する。
.B \-tx2
と等価。
.TP
.B \-i
10 進 short として出力する。
.B \-td2
と等価。
.TP
.B \-l
10 進 long として出力する。
.B \-td4
と等価。
.TP
.B \-o
8 進 short として出力する。
.B \-to2
と等価。
.TP
.B \-x
16 進 short として出力する。
.B \-tx2
と等価。
.TP
.B \-C, \-\-traditional
POSIX 以前の、オプション以外の引き数のうち、古いバージョンの
.B od
が受け付けたものを認識する。
.PP
たとえば以下の書式:
.sp	  
.B od \-\-traditional
.RI [ FILE "] [[" \fB+\fR]\fIOFFSET\fR[\fB.\fR][\fBb\fR] 
.RI [[ \fB+\fR ] LABEL [\fB.\fR][\fBb\fR]]]
.sp		    
を使うと、最大 1 つのファイルと、オフセットおよび擬似スタートアドレス
\fILABEL\fP を指定できる。
デフォルトでは
.I OFFSET
は 8 進数と解釈され、
整形・出力する前にスキップする入力ファイルのバイト数を示す。
小数点を付加すると、
.I OFFSET
は 10 進数とみなされる。
10 進の指定がなく、
.I offset
が `\fB0x\fR' または `\fB0X\fR' で始まる場合は 16 進数と解釈される。
`\fBb\fR' が後置されると
.I offset
を 512 倍したバイト分がスキップされる。
.I LABEL
引き数も
.I OFFSET
のように解釈されるが、これはスタート地点の擬似アドレスを指定する。
擬似アドレスは通常のアドレスの後に括弧付きで表示される。
.SH 注意
プログラムのバグについては bug-textutils@gnu.org に報告してください。
.br
man ページは Ragnar Hojland Espinosa
<ragnar@ragnar-hojland.com> が作成しました。