This file is indexed.

/usr/share/doc/apt-doc/guide.ja.html/ch4.html is in apt-doc 1.0.9.8.4.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <title>第4章 インターフェース</title>
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1"/>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
    <link rel="home" href="index.html" title="APT ユーザガイド"/>
    <link rel="up" href="index.html" title="APT ユーザガイド"/>
    <link rel="prev" href="ch3.html" title="第3章 DSelect"/>
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">第4章 インターフェース</th>
        </tr>
        <tr>
          <td align="left"><a accesskey="p" href="ch3.html">戻る</a> </td>
          <th width="60%" align="center"> </th>
          <td align="right"> </td>
        </tr>
      </table>
      <hr/>
    </div>
    <div class="chapter">
      <div class="titlepage">
        <div>
          <div>
            <h1 class="title"><a id="ch4"/>第4章 インターフェース</h1>
          </div>
        </div>
      </div>
      <div class="toc">
        <p>
          <strong>目次</strong>
        </p>
        <dl class="toc">
          <dt>
            <span class="section">
              <a href="ch4.html#s4.1">4.1. スタートアップ</a>
            </span>
          </dt>
          <dt>
            <span class="section">
              <a href="ch4.html#s4.2">4.2. 状態レポート</a>
            </span>
          </dt>
          <dt>
            <span class="section">
              <a href="ch4.html#s4.3">4.3. 状態表示</a>
            </span>
          </dt>
          <dt>
            <span class="section">
              <a href="ch4.html#s4.4">4.4. Dpkg</a>
            </span>
          </dt>
        </dl>
      </div>
      <p>
APT の <span class="command"><strong>dselect</strong></span> メソッドと <span class="command"><strong>apt-get</strong></span>
は共に同一のインターフェイスを共有しています。通常は行う内容を告知して実行する簡単なシステムです。<a href="#ftn.idp52682720" class="footnote" id="idp52682720"><sup class="footnote">[2]</sup></a> 実行内容のまとめを告知した後 APT
が参考になる状態メッセージをいくらか表示するため、どれくらい進んでいるのか、あるいは残り作業がどれくらいあるのか見積もることができるようになっています。
</p>
      <div class="section">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title"><a id="s4.1"/>4.1. スタートアップ</h2>
            </div>
          </div>
        </div>
        <p>
update 以外のあらゆる操作で、APT はいくつか処理を行い内部状態を準備します。また、システムの状態についてもいくらか確認します。この処理は
<code class="literal">apt-get check</code> によりいつでも実行できます。
</p>
        <pre class="screen">
# apt-get check
Reading Package Lists... Done
Building Dependency Tree... Done
</pre>
        <p>
これが最初に行うのはパッケージファイルを全てメモリに読み込むことです。APT
はキャッシュを使うようになっているので、この処理は次に実行するときには早く終わります。見つけられないパッケージファイルがある場合は無視され、apt-get
終了時に注意を表示します。
</p>
        <p>
最後の処理はシステムの依存関係の詳細な分析です。インストール、あるいは展開されたパッケージの依存関係を全て確認し、問題ないか判断します。問題が見つかった場合は報告し、<span class="command"><strong>apt-get</strong></span>
の実行を拒否します。
</p>
        <pre class="screen">
# apt-get check
Reading Package Lists... Done
Building Dependency Tree... Done
You might want to run apt-get -f install' to correct these.
Sorry, but the following packages have unmet dependencies:
  9fonts: Depends: xlib6g but it is not installed
  uucp: Depends: mailx but it is not installed
  blast: Depends: xlib6g (&gt;= 3.3-5) but it is not installed
  adduser: Depends: perl-base but it is not installed
  aumix: Depends: libgpmg1 but it is not installed
  debiandoc-sgml: Depends: sgml-base but it is not installed
  bash-builtins: Depends: bash (&gt;= 2.01) but 2.0-3 is installed
  cthugha: Depends: svgalibg1 but it is not installed
           Depends: xlib6g (&gt;= 3.3-5) but it is not installed
  libreadlineg2: Conflicts:libreadline2 (&lt;&lt; 2.1-2.1)
</pre>
        <p>
この例ではシステムに libreadlineg2
に関する重大な問題を含めて多数の問題があります。未解決の依存関係があれば各パッケージごとにそのパッケージに問題があることを示し、併せて未解決の依存関係を1行で出力します。そのパッケージの依存問題の理由について簡潔な説明も添えられます。
</p>
        <p>
システムがこのように壊れた状態となる原因は2つあります。1つ目はアップグレード実行時にパッケージ間の難解な依存関係を
<span class="command"><strong>dpkg</strong></span> がいくらか欠いていることによります。<a href="#ftn.idp52694432" class="footnote" id="idp52694432"><sup class="footnote">[3]</sup></a>2つ目はパッケージのインストール処理中に何か失敗した場合です。この状況では依存するパッケージがインストールされないままパッケージが展開されている可能性があります。
</p>
        <p>
APT がパッケージのインストール順序に特定の制約を設けていることにより2つ目の状況は1つ目の状況と比べて重大ですらなくなります。どちらの場合でも
<span class="command"><strong>apt-get</strong></span><code class="literal">-f</code> オプションを指定することで APT
は解決方法を推測し、処理を続けます。APT <span class="command"><strong>dselect</strong></span> メソッドでは常に
<code class="literal">-f</code> オプションを有効にして、メンテナスクリプトでの問題が起きた場合でも簡単に処理を継続できるようにしています。
</p>
        <p>
しかし、1つ目の状況により重大な壊れ方になっているシステムの修正に <code class="literal">-f</code>
オプションを使った場合はインストールにすぐに失敗、あるいはインストール順序がおかしくなる可能性があります。どちらの場合も、APT
が処理を十分に進められるところまで手作業により dpkg を使って (恐らく強制するオプションを指定して) 状況を修正する必要があります。
</p>
      </div>
      <div class="section">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title"><a id="s4.2"/>4.2. 状態レポート</h2>
            </div>
          </div>
        </div>
        <p>
処理を続ける前に <span class="command"><strong>apt-get</strong></span>
は実行しようとする処理について報告します。通常この報告は実行される操作の種類を反映したものになりますが、一般的要素がいくつかあります。どの場合でもこの処理一覧は最終的な状態を示し、<code class="literal">-f</code>
オプションその他の実行されるコマンドに関連する動作を考慮したものとなります。
</p>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.1"/>4.2.1. 追加パッケージリスト</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
The following extra packages will be installed:
  libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl
  mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base
  bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy
  squake pgp-i python-base debmake ldso perl libreadlineg2
  ssh
</pre>
          <p>
追加パッケージリストはコマンドラインで指示した以外にインストールやアップグレードされるパッケージを全て表示します。これは
<code class="literal">install</code>
コマンドの場合にのみ生成されます。一覧に挙げられるパッケージは自動インストールの結果による場合が多くなります。
</p>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.2"/>4.2.2. 削除するパッケージ</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
The following packages will be REMOVED:
  xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix
  xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel
  xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid
  nas xpilot xfig
</pre>
          <p>
削除するパッケージリストはシステムから削除されるパッケージを全て表示します。これはどの操作でも起きるもので、重要なものが失われることのないように注意深く確認すべきです。<code class="literal">-f</code>
オプションを使った場合はパッケージの削除を伴うことが特に多く、そのためこのオプションを指定した場合は特に注意を払うようにしてください。この一覧にはインストールの中止等により一部だけがインストールされているために削除されるパッケージが含まれることがあります。
</p>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.3"/>4.2.3. 新規パッケージリスト</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
The following NEW packages will installed:
  zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base
</pre>
          <p>
新規パッケージリストでは単純にこれから起きることを再通知します。このパッケージ一覧は現在システムにインストールされておらず、APT
処理後には存在することになります。
</p>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.4"/>4.2.4. 一時固定リスト</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
The following packages have been kept back
  compface man-db tetex-base msql libpaper svgalib1
  gs snmp arena lynx xpat2 groff xscreensaver
</pre>
          <p>
システム全体をアップグレードする場合、新しいパッケージが必要であったり既にインストールされているパッケージと競合するためにパッケージの新しいバージョンがインストールできないということがあります。この場合、そのパッケージは一時固定リストに表示されます。この一覧に挙げられたパッケージをインストールする最善の方法は
<code class="literal">apt-get install</code> または <span class="command"><strong>dselect</strong></span>
を使ってその問題を解決することです。
</p>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.5"/>4.2.5. 保留パッケージの警告</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
The following held packages will be changed:
  cvs
</pre>
          <p>
保留となっているパッケージをインストールするように APT
に指示することもできます。その際、保留となっているパッケージを変更することを警告します。これは dist-upgrade または install
を指示したときにしか起きないはずです。
</p>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.6"/>4.2.6. 最後のまとめ</h3>
              </div>
            </div>
          </div>
          <p>
最後に、APT は発生する全変更のまとめを表示します。
</p>
          <pre class="screen">
206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.
12 packages not fully installed or removed.
Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used.
</pre>
          <p>
まとめの1行目は単純に一覧を全て短くまとめたもので、アップグレードされる (既にインストールされていて新しいバージョンが利用可能な)
パッケージの数についても示します。2行目は設定が完了していないパッケージの数を示し、インストールを中止した場合にこれに集計されることがあります。最終行はそのインストールで必要となる容量の要件を示します。最初の数値の組はアーカイブファイルのサイズを示します。この1つ目の数値はリモートから取得してくる必要のあるバイト数、2つ目は必要となる全アーカイブの合計サイズを示します。次の数値は現在インストールされているパッケージと新しくインストールしたパッケージのサイズの違いを示します。これは処理が全て終わった後に
/usr で消費される容量にほぼ相当します。パッケージを大量に削除する場合は解放される容量を示すこともあります。
</p>
          <p>
他の報告として、-u オプションを使うとアップグレードされるパッケージを表示します。これは前に示した例と似たものです。
</p>
        </div>
      </div>
      <div class="section">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title"><a id="s4.3"/>4.3. 状態表示</h2>
            </div>
          </div>
        </div>
        <p>
アーカイブやパッケージファイルのダウンロード中、APT は状態を示す一連のメッセージを表示します。
</p>
        <pre class="screen">
# apt-get update
Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages
Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages
Hit http://llug.sep.bnl.gov/debian/ testing/main Packages
Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages
Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages
11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s
</pre>
        <p>
APT
がファイルの取得を開始すると、最終行でダウンロードの進捗状況を示しつつ<span class="emphasis"><em>取得</em></span>で始まる行が表示されます。進捗の最初のパーセント値は全ファイルに対する取得済みの全体での割合を示します。残念ながらパッケージファイルのサイズは不明なので
<code class="literal">apt-get update</code> は不正確な予測を行う可能性があります。
</p>
        <p>
状態を示す行の次の節は各ダウンロードスレッドごとに1度ずつ繰り返され、進行中の操作や処理についての有用な情報をいくらか示します。この節は単純に
<span class="emphasis"><em>Forking</em></span> となっていることもあり、その場合は OS
がダウンロード用のモジュールを読み込んでいることを示します。[
の後の最初の語は履歴に表示されている取得番号です。その次の語はダウンロード対象の名前の短縮形です。アーカイブの場合は取得中のパッケージの名前が入ります。
</p>
        <p>
単一引用符内はダウンロードのやりとりの進捗を示す有益な文字列です。標準的には<span class="emphasis"><em>...へ接続しています</em></span>から<span class="emphasis"><em>ファイルを待っています</em></span>へ、それから<span class="emphasis"><em>...をダウンロードしています</em></span>または<span class="emphasis"><em>...を再開しています</em></span>へと進みます。最後の値はリモートサイトからダウンロードしたバイト数です。ダウンロードが始まるとこれは
<code class="literal">102/10.2k</code>
のように表示され、この場合10.2キロバイトのうち102バイトが取得済みであることを示します。合計サイズは常に4ケタで表示され、表示空間を保つようになっています。サイズ表示の後はそのファイル自体の進捗状況を百分率で示したものです。その2つ後は瞬間的な平均速度です。この値は5秒ごとに更新され、その間のデータ転送速度を反映します。最後は推定転送時間を表示しています。これは定期的に更新され、表示している転送速度で全て完了する時間を表示します。
</p>
        <p>
状態表示は0.5秒ごとに更新してダウンロードの進捗状況を絶えず通知し、取得行は新しいファイルの処理が始まるたびに流れていきます。状態表示は絶えず更新されるためファイルへの記録には適しません。<code class="literal">-q</code>
オプションを使うと状態を表示しないようにできます。
</p>
      </div>
      <div class="section">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title"><a id="s4.4"/>4.4. Dpkg</h2>
            </div>
          </div>
        </div>
        <p>
APT はアーカイブのインストールに <span class="command"><strong>dpkg</strong></span> を使い、ダウンロードの完了後は
<span class="command"><strong>dpkg</strong></span> インターフェイスに切り替わります。<span class="command"><strong>dpkg</strong></span>
もパッケージの処理中にいくつか質問し、パッケージ自体も複数質問するかもしれません。通常それぞれの質問の前にそれが何を聞いているのか説明します。その質問の内容は多岐にわたるものであり、ここで説明できるものでは全くありません。
</p>
      </div>
      <div class="footnotes">
        <br/>
        <hr/>
        <div id="ftn.idp52682720" class="footnote">
          <p><a href="#idp52682720" class="para"><sup class="para">[2] </sup></a> <span class="command"><strong>dselect</strong></span> メソッドは実際に <span class="command"><strong>apt-get</strong></span>
に対するラッパースクリプト群です。このメソッドでは <span class="command"><strong>apt-get</strong></span>
単体に存在している以上の機能を実際に提供しています。 </p>
        </div>
        <div id="ftn.idp52694432" class="footnote">
          <p><a href="#idp52694432" class="para"><sup class="para">[3] </sup></a> APT はそれでも既知の依存関係を全て検討し、パッケージが壊れた状態となることを回避しようとします。 </p>
        </div>
      </div>
    </div>
    <div class="navfooter">
      <hr/>
      <table width="100%" summary="Navigation footer">
        <tr>
          <td align="left"><a accesskey="p" href="ch3.html">戻る</a> </td>
          <td align="center"> </td>
          <td align="right"> </td>
        </tr>
        <tr>
          <td align="left" valign="top">第3章 DSelect </td>
          <td align="center">
            <a accesskey="h" href="index.html">ホーム</a>
          </td>
          <td align="right" valign="top"> </td>
        </tr>
      </table>
    </div>
  </body>
</html>