summaryrefslogtreecommitdiffstats
path: root/man/ja/dpkg-split.pod
blob: ee32e74d10fc9ead2a55cb1076416207041b8b10 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 名前

dpkg-split - Debian パッケージアーカイブの分割/統合ツール

=head1 書式

B<dpkg-split> [I<option>...] I<command>

=head1 説明

B<dpkg-split> は Debian バイナリパッケージのファイルを小さいパートに分割したり、それらを再度統合したりするツールであり、フロッピーディスクのような容量の小さい媒体上に、サイズの大きいパッケージファイルを保管できるようにする。

これは、B<--split>, B<--join>, B<--info> オプションを手動で指定することにより行われる。

B<dpkg-split> には B<--auto> オプションにより実行される自動モードも備わっている。自動モードでは、存在しているがまだ統合されていないパートのキューを管理することで、すべてのパートが確認できた時点でそれらを統合する。キューの管理は、B<--listq> および B<--discard> オプションで行うことができる。

分割、統合、キューイング処理のいずれも、標準出力に有用なメッセージを出力する。これらは無視しても問題ない。

=head1 コマンド

=over 

=item B<-s>, B<--split> I<complete-archive> [I<prefix>]

単一の Debian バイナリパッケージを幾つかのパートに分割する。

各パートは、I<prefix>B<.>I<N>B<of>I<M>B<.deb> のように名づけられる。ここで、I<N> は 1 から始まるパート番号であり、I<M> はパートの総数である (いずれも 10 進数である)。

I<prefix> が指定されていない場合は、I<complete-archive> ファイル名が、ディレクトリ部分も含めて用いられるが、末尾の B<.deb> 部分は削除される。

=item B<-j>, B<--join> I<part>...

パッケージファイルのパート群を集約して、分割前のオリジナルファイルに統合する。

引数として指定された各パートのファイルは、オリジナルのバイナリファイルのすべてのパートを含んでいること。パートを順番に並べて指定する必要はないが、同じパートのファイルを複数回指定することはできない。

各パートは分割時に指定されたサイズが同一である必要がある。これは、通常各パートが単一の B<dpkg-split --split> の実行から生成されることを意味する。

パートのファイル名は、統合処理において重要ではない。

生成されたファイルは、デフォルトで I<package>B<_>I<version>B<_>I<arch>B<.deb> というファイル名になる。

=item B<-I>, B<--info> I<part>...

パートのファイルに関する情報を人が読みやすい形式で表示する。バイナリパッケージのパート以外のファイルが引数で指定された場合は、それを指摘するメッセージを (標準出力に) 代わりに表示する。

=item B<-a>, B<--auto -o> I<complete-output> I<part>

自動的にパートをキューイングして、可能であればパッケージを再統合する。

I<part> で指定されたパートが検査され、同じパッケージファイルのパートのキューにあるパッケージの別のパート (もしあれば) と比較される。

I<part> が属するパッケージファイルのすべてのパートが利用可能な場合、パッケージは統合され、I<complete-output> に書き出される (ファイルが既存の場合もエラーとはならないが、通常は推奨されない)。

それ以外の場合、I<part> がキューにコピーされ、I<complete-output> は作成されない。

I<part> が分割されたバイナリパッケージのパート以外の場合、B<dpkg-split> は戻り値 B<1> で終了する。何らかのトラブルが発生した場合、戻り値 B<2> で終了する。

B<--auto> を使用する場合、B<--output> もしくは B<-o> オプションも指定すること (これを必須にしないと、呼び出したプログラムが出力ファイル名を知る術がなくなってしまう)。

=item B<-l>, B<--listq>

統合されるパッケージのキューの内容を一覧表示する。

キューにパートが存在している各パッケージファイルについて、パッケージ名とキューにあるパート、キューに格納されているバイト数が出力される。

=item B<-d>, B<--discard> [I<package>...]

パッケージの残りのパートが揃うまでキューに格納されているパートをキューから削除する。

I<package> が指定されなかった場合、キューは完全に消去される。何らかのパッケージが指定された場合、そのパッケージのパートのみが削除される。

=item B<-?>, B<--help>

利用方法を表示して終了する。

=item B<--version>

バージョン情報を表示して終了する。

=back

=head1 オプション

=over 

=item B<--depotdir> I<directory>

Specifies an alternative directory for the queue of parts awaiting automatic reassembly. The default is B<%ADMINDIR%/parts>.

=item B<--admindir> I<directory>

Set the administrative directory to I<directory> (since dpkg 1.21.10).  This is where the I<statoverride> file is stored.  Defaults to «I<%ADMINDIR%>» if B<DPKG_ADMINDIR> has not been set.

=item B<--root> I<directory>

Set the root directory to B<directory> (since dpkg 1.21.10), which sets the installation directory to «I<directory>» and the administrative directory to «I<directory>B<%ADMINDIR%>» if B<DPKG_ROOT> has not been set.

=item B<-S>, B<--partsize> I<kibibytes>

ファイル分割の際のパートの最大サイズを kibibyte (1024 byte) 単位で指定する。デフォルトは 450 KiB である。

=item B<-o>, B<--output> I<complete-output>

統合の際の出力ファイル名を指定する。

これは、(B<--join> による) 手動統合の際のデフォルトのファイル名に優先する。また、(B<--auto> による) 自動でのキューイングおよび統合の際には必須である。

=item B<-Q>, B<--npquiet>

自動でのキューイングおよび統合が行われる際、B<dpkg-split> は通常バイナリパッケージのパートでない I<part> が指定されるとメッセージを出力するが、このオプションによりメッセージが抑止され、B<dpkg> のようなプログラムがパッケージの分割や統合を扱う際に、余計なメッセージを出力することが避けられる。

=item B<--msdos>

Forces the output filenames generated by B<--split> to be MSDOS-compatible.

これにより、入力ファイル名から生成されたデフォルト値の prefix、引数として指定された prefix いずれもが切り詰められる。英数字は小文字にされ、プラス記号は B<x> に置き換えられ、その他の文字は破棄される。

必要な切り詰めが行われた結果として、I<prefixN>B<of>I<M>B<.deb> 形式のファイル名が生成される。

=back

=head1 終了ステータス

=over 

=item B<0>

要求された分割、統合、その他のコマンドは成功した。B<--info> コマンドはファイルがバイナリパッケージのパートでなかった場合も含め、成功としてカウントする。

=item B<1>

B<--auto> の場合のみ発生し、I<part> ファイルがバイナリパッケージのパートではなかったことを示す。

=item B<2>

Fatal or unrecoverable error due to invalid command-line usage, a file that looked like a package part file but was corrupted, or interactions with the system, such as accesses to the database, memory allocations, etc.

=back

=head1 環境変数

=over 

=item B<DPKG_ROOT>

If set and B<--root> option has not been specified, it will be used as the filesystem root directory (since dpkg 1.21.10).

=item B<DPKG_ADMINDIR>

If set and the B<--admindir> or B<--root> options have not been specified, it will be used as the B<dpkg> data directory (since dpkg 1.21.10).

=item B<DPKG_DEBUG>

Sets the debug mask (since dpkg 1.21.10) from an octal value.  The currently accepted flags are described in the B<dpkg --debug> option, but not all these flags might have an effect on this program.

=item B<DPKG_COLORS>

Sets the color mode (since dpkg 1.18.5).  The currently accepted values are: B<auto> (default), B<always> and B<never>.

=item B<SOURCE_DATE_EPOCH>

If set, it will be used as the timestamp (as seconds since the epoch) in the B<deb-split>(5)'s B<ar>(5) container.

=back

=head1 ファイル

=over 

=item I<%ADMINDIR%/parts>

パートを構成するファイルが自動統合を待機するデフォルトのキューディレクトリ。

このディレクトリ内のファイル名は B<dpkg-split> の内部形式となっており、その他のプログラムから参照されることを想定していない。いかなる場合もファイル名の形式に依存すべきではない。

=back

=head1 バグ

キューにあるパッケージの詳細は、キューディレクトリを自分で調べない限り確認することができない。

ファイルがバイナリパッケージのパートかどうかを簡単に確認する手段が存在しない。

=head1 関連項目

B<deb>(5), B<deb-control>(5), B<dpkg-deb>(1), B<dpkg>(1).


=head1 翻訳者

高橋 基信 <monyo@monyo.com>.
喜瀬 浩 <kise@fuyuneko.jp>.
関戸 幸一 <sekido@mbox.kyoto-inet.or.jp>.
鍋谷 栄展 <nabe@debian.or.jp>.
倉澤 望 <nabetaro@debian.or.jp>.
石川 睦 <ishikawa@linux.or.jp>.
鵜飼 文敏 <ukai@debian.or.jp>.
中野 武雄 <nakano@apm.seikei.ac.jp>.

=head1 翻訳校正

Debian JP Documentation ML <debian-doc@debian.or.jp>.