aboutsummaryrefslogtreecommitdiff
path: root/documentation/manual-pages/ja/man8/kgzip.8
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/manual-pages/ja/man8/kgzip.8')
-rw-r--r--documentation/manual-pages/ja/man8/kgzip.8141
1 files changed, 141 insertions, 0 deletions
diff --git a/documentation/manual-pages/ja/man8/kgzip.8 b/documentation/manual-pages/ja/man8/kgzip.8
new file mode 100644
index 0000000000..1e4874b957
--- /dev/null
+++ b/documentation/manual-pages/ja/man8/kgzip.8
@@ -0,0 +1,141 @@
+.\" Copyright (c) 1999 Global Technology Associates, Inc.
+.\" 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.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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.
+.\"
+.\" %FreeBSD: src/usr.sbin/kgzip/kgzip.8,v 1.8 2004/07/02 23:12:46 ru Exp %
+.\"
+.\" $FreeBSD$
+.\"
+.Dd July 19, 1999
+.Dt KGZIP 8
+.Os
+.Sh 名称
+.Nm kgzip
+.Nd カーネルを圧縮する
+.Sh 書式
+.Nm
+.Op Fl cv
+.Op Fl f Ar format
+.Op Fl l Ar loader
+.Op Fl o Ar output
+.Ar file
+.Sh 解説
+.Nm
+ユーティリティは、カーネルその他のブート可能バイナリを圧縮します。
+この動作は次の 2 つのフェーズからなります。
+.Bl -enum
+.It
+実行可能ファイルのロードイメージは、
+.Sq text
+セグメントと
+.Sq data
+セグメント以外のすべてを省略して作成されます。
+このイメージを
+.Xr gzip 1
+を用いて圧縮し、
+再配置可能なオブジェクト形式として出力します。
+.It
+出力されるオブジェクトファイルは、特殊な自立ローダとともにリンクされ、
+第 2 レベルもしくは第 3 レベルのブートストラッププログラムによるブートに
+適した実行ファイルが生成されます。
+.El
+.Pp
+サポートする入力ファイルは 32 ビット ELF と a.out ZMAGIC の形式です。
+.Pp
+.Ar file
+オペランドが
+.Sq .o
+接尾子を持つ場合、入力はリンクフェーズにあると見なされ、最初のフェーズは
+省略されます。
+.Pp
+オプションは次のとおりです。
+.Bl -tag -width Fl
+.It Fl c
+リンクフェーズを省略します。
+.It Fl v
+オブジェクトファイル情報を表示します。
+.It Fl f Ar format
+出力形式に
+.Ar format
+を使用します。
+.Ar format
+は
+.Sq aout
+または
+.Sq elf
+です。デフォルトの形式は ELF です。
+.It Fl l Ar loader
+.Ar loader
+をローダとしてリンクします。
+.It Fl o Ar output
+出力ファイルの名前を
+.Ar output
+とします。
+デフォルトの名前は、(再配置可能形式については) 入力ファイル名の接尾子を
+.Sq .o
+にしたものです。または、(実行可能形式については) 入力ファイルの接尾子を
+.Sq .kgz
+にしたものです。
+.El
+.Sh 注
+以下と等価な大域変数が出力の中で定義されます。
+.Bd -literal
+struct kgz_hdr {
+ char ident[4]; /* 識別子: "KGZ" */
+ uint32_t dload; /* デコードされたイメージのロードアドレス */
+ uint32_t dsize; /* デコードされたイメージの大きさ */
+ uint32_t isize; /* メモリ中のイメージの大きさ */
+ uint32_t entry; /* エントリポイント */
+ uint32_t nsize; /* エンコードされたイメージの大きさ */
+ } kgz;
+
+uint8_t kgz_ndata[]; /* エンコードされたデータ */
+.Ed
+.Pp
+エンコードされたデータは、単に
+.Xr gzip 1
+の出力です。ヘッダ (オプションフィールドは一切持ちません)、圧縮された
+データ、32 ビットの CRC とサイズの値を持ちます。
+.Sh 関連ファイル
+.Bl -tag -width /usr/lib/kgzldr.o -compact
+.It Pa /usr/lib/kgzldr.o
+デフォルトのローダ。
+.El
+.Sh 関連項目
+.Xr gzip 1 ,
+.Xr ld 1 ,
+.Xr a.out 5 ,
+.Xr elf 5 ,
+.Xr boot 8 ,
+.Xr loader 8
+.Sh 診断
+.Ex -std
+.Sh 作者
+.An Robert Nordier Aq rnordier@FreeBSD.org
+.Sh バグ
+シンボル情報は失われていますので、カーネルの圧縮にこのユーティリティを
+使う利点は、
+.Xr loader 8
+が使用できない状況に限られます。それ以外の場合、単に
+.Xr gzip 1
+を使ってカーネルを圧縮する方が望ましいでしょう。