This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.
Please visit our production wiki at https://wiki.gentoo.org
Gentoolkit
Not to be confused with Genkernel.
Gentoolkit は、 Gentoo のシステムの管理を容易にするためのツールセットです。この文書は、 Gentoolkit にあるいくつかのツールについての基本的部分を述べています。
はじめに
Gentoolkit とは何ですか？
Gentooはユニークなディストリビューションであり、他のディストリビューションには全然存在しないような複雑なところがあります。Gentooの開発者や貢献者はそうした複雑さを見つけると、それらに対処するユーザーや管理者を補助するためのツールを作成しました。多くのツールが Gentoo Project に寄贈され、 app-portage/gentoolkit に含まれています。
いまのところ、Gentoolkit には2つのバージョンがあります: app-portage/gentoolkit と app-portage/gentoolkit-dev です。前者は管理用のスクリプトを含むのに対し、後者はGentooの開発の補助に特化したスクリプトを含んでいます。Gentooの開発者は Gentoolkit のメンテナーに連絡することで自身のスクリプトを app-portage/gentoolkit-dev に含めることができます。この文書の残りの部分では app-portage/gentoolkit のみについて触れます。
Gentoolkit は、ユーザーのパッケージ管理や彼らのシステムで起こっている事の追跡を補助するための有用なツールを非常にたくさん含んでいます。多くのユーザー - 特にシステムをしばしばアップデートするユーザー - は Gentoolkit をインストールしておくことで恩恵を受けるでしょう。
インストール
Emerge
他の多くの Gentoo パッケージと同様に、インストールは emerge するだけとシンプルです:
root #emerge --ask app-portage/gentoolkitGentoolkit のツールの多くはインストールされているシステムについての重要な情報を表示するものか、あるいはルート権限を必要とするものです。そのため、いくつかのプログラムはルート権限を持つユーザーによってのみ実行可能(あるいは正常に機能させることが可能)です。
ドキュメントを探す
プログラムのすべてのドキュメント(manページを除く)は /usr/share/doc/gentoolkit-[version]/[program-name]/ に保存されています。
euse
euse は様々な場所のUSEフラグを見たり、セット・アンセットするためのツールです。USEフラグの詳細については USE Flags を参照してください。完全なヘルプとすべてのオプションについては euse -h をご覧ください。
USEフラグを表示、セット、アンセットする
euse -a コマンドは現在有効なUSEフラグを読み込んで表示します。
現在、euse はフラグがセットされているか否か、またフラグがセットされているすべての場所を表示するために5つの行を使用します。各行は以下のとおりです -- +/-、Environmentでセットされているか、make.Confでセットされているか、make.Defaultsでセットされれているか、make.Globalsでセットされているか。出力は[+ECDG]のようになります。
root #euse -aX [+ CD ] aalib [+ ] acpi [+ C ] alsa [+ C ] apache2 [+ C ] apm [+ D ] avi [+ D ] berkdb [+ D ] bitmap-fonts [+ D ] bonobo [+ ] cdr [+ C ] crypt [+ CD ] cscope [+ C ] cups [+ CD ] curl [+ ] emboss [+ D ] encode [+ D ] esd [+ ] fam [+ ] fbcon [+ C ] firefox [+ C ] font-server [+ D ] foomaticdb [+ D ] fortran [+ D ] gd [+ C ] gdbm [+ D ] gif [+ CD ] gimpprint [+ C ] gnome [+ CD ] gphoto2 [+ ] gpm [+ CD ] gstreamer [+ C ] gtk [+ D ] gtkhtml [+ C ] guile [+ ] imagemagick [+ ] imlib [+ CD ] innodb [+ ] ipv6 [+ D ] javascript [+ C ] jpeg [+ CD ] kde [+ D ] ldap [+ ] libg++ [+ CD ] libwww [+ CD ] mad [+ CD ] mbox [+ C ] md5sum [+ C ] mikmod [+ CD ] mmx [+ C ] motif [+ CD ] mp3 [+ ] mpeg [+ CD ] mpeg4 [+ C ] mysql [+ C ] ncurses [+ CD ] nls [+ D ] nvidia [+ C ] odbc [+ ] offensive [+ ] ogg [+ CD ] opengl [+ CD ] oss [+ D ] pam [+ CD ] pdflib [+ CD ] perl [+ CD ] png [+ CD ] python [+ CD ] qt [+ D ] quicktime [+ CD ] readline [+ CD ] ruby [+ ] sdl [+ CD ] slang [+ D ] spell [+ CD ] sse [+ C ] ssl [+ CD ] svga [+ CD ] tcltk [+ C ] tcpd [+ D ] tiff [+ C ] truetype [+ CD ] usb [+ C ] vanilla [+ C ] x86 [+ C ] xml [+ ] xosd [+ C ] xv [+ CD ] xvid [+ C ] zlib [+ CD ]
同様に、有効なグローバルUSEフラグを表示するには euse -a -g コマンドが使用されます。euse -a -l コマンドは有効なローカルUSEフラグについて同様にします。-g や -l は euse のサブオプションであり、正しく動作するにはこれらの前に(-aのような)オプションが必要です。
root #euse -a -lbitmap-fonts [+ D ] font-server [+ D ] fortran [+ D ] gimpprint [+ C ] md5sum [+ C ] mpeg4 [+ C ] nvidia [+ C ] offensive [+ ] truetype [+ CD ]
euse はUSEフラグをセットまたはアンセットすることができます。このために使われるコマンドは euse -E flagname (フラグを有効化) および euse -D flagname (フラグを無効化)です。
euse -E や euse -D コマンドそれ自体を(フラグなしで)使用してはいけません。 /etc/portage/make.conf 内ですべてのUSEフラグをセット/アンセットしてしまいます。バックアップが /etc/portage/make.conf.euse_backup に保存されはしますが、euse -E や euse -D を使用する際は注意を払ってください！
USEフラグを有効化する:
root #euse -E 3dfx/etc/portage/make.conf was modified, a backup copy has been placed at /etc/portage/make.conf.euse_backup
コマンドが実行された後の /etc/portage/make.conf ファイルはこのようになります:
make.conf3dfx USEフラグを有効化した後USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ ogg odbc offensive opengl pam pdflib perl png python \ quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ vanilla X xosd xv xvid x86 zlib 3dfx"
USEフラグを無効化する:
root #euse -D 3dfx/etc/portage/make.conf was modified, a backup copy has been placed at /etc/portage/make.conf.euse_backup
コマンドの後の /etc/portage/make.conf:
make.conf3dfx USEフラグを無効化した後USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ ogg odbc offensive opengl pam pdflib perl png python \ quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ vanilla X xosd xv xvid x86 zlib -3dfx"
euse はフラグを /etc/portage/make.conf から物理的に除去しません。euse は
- (マイナス) をフラグの前に追加してフラグをアンセットします。不要な変数を避けるため、/etc/portage/make.conf を手動でクリーンアップする必要があるかもしれません。あるいは、-P (purge)オプションを使用してフラグを取り除きます。たとえば、euse -P 3dfx は 3dfx フラグを取り除きます。そのほかのツール
revdep-rebuild
このツールはGentooのリバース依存関係を再構築します。これは依存パッケージの更新の結果壊れたパッケージを探すため、インストールされている ebuild をスキャンします。それらのパッケージをユーザーのために自動的にemergeすることもできますが、一定のパッケージは現在インストールされている依存関係の下では正しく動作しないこともあり、こうした場合にはその壊れたパッケージをより最近のバージョンにアップグレードしなければなりません。revdep-rebuild はフラグを emerge に渡すので、--pretend フラグを使用して何が再度emergeされるのか事前に確認することができます。
root #revdep-rebuild -p* Configuring search environment for revdep-rebuild * Checking reverse dependencies * Packages containing binaries and libraries broken by a package update * will be emerged. * Collecting system binaries and libraries * Generated new 1_files.rr * Collecting complete LD_LIBRARY_PATH * Generated new 2_ldpath.rr * Checking dynamic linking consistency [ 48% ] * broken /usr/lib/gstreamer-0.10/libgsttaglib.la (requires /usr/lib/libtag.la) [ 64% ] * broken /usr/lib/libgdkglext-x11-1.0.la (requires /usr/lib/libGLU.la) [ 67% ] * broken /usr/lib/libgtkglext-x11-1.0.la (requires /usr/lib/libGLU.la) [ 85% ] * broken /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gdkgl/_gdkgl.la (requires /usr/lib/libGLU.la) * broken /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gtkgl/_gtkgl.la (requires /usr/lib/libGLU.la) [ 97% ] * broken /usr/qt/3/lib/libqt-mt.la (requires -lpng) [ 100% ] * Generated new 3_broken.rr * Assigning files to packages * /usr/lib/gstreamer-0.10/libgsttaglib.la -> media-plugins/gst-plugins-taglib * /usr/lib/libgdkglext-x11-1.0.la -> x11-libs/gtkglext * /usr/lib/libgtkglext-x11-1.0.la -> x11-libs/gtkglext * /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gdkgl/_gdkgl.la -> dev-python/pygtkglext * /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gtkgl/_gtkgl.la -> dev-python/pygtkglext * /usr/qt/3/lib/libqt-mt.la -> x11-libs/qt * Generated new 4_raw.rr and 4_owners.rr * Cleaning list of packages to rebuild * Generated new 4_pkgs.rr * Assigning packages to ebuilds * Generated new 4_ebuilds.rr * Evaluating package order * Generated new 5_order.rr * All prepared. Starting rebuild emerge --oneshot --pretend dev-python/pygtkglext:0 media-plugins/gst-plugins-taglib:0.10 x11-libs/gtkglext:0 x11-libs/qt:3 These are the packages that would be merged, in order: Calculating dependencies... done! [ebuild R ] media-plugins/gst-plugins-taglib-0.10.17 [ebuild R ] x11-libs/gtkglext-1.2.0 [ebuild R ] x11-libs/qt-3.3.8b-r2 [ebuild R ] dev-python/pygtkglext-1.1.0 * Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild.
パッケージを再ビルドするには revdep-rebuild を -p フラグなしで実行します。これで、リストされたパッケージが再度emergeされます。
glsa-check
glsa-check はさまざまな GLSA (Gentoo Linux Security Advisory)を追跡する主にテスト目的のツールであり、やがては emerge や equery に統合されるでしょう。
eread
eread はバージョン2.1以降の Portage によって生成されるelogファイルを表示するシンプルなユーティリティーです。elogファイルの保存は、2つの変数を /etc/portage/make.conf でセットすることで有効化できます:
make.confelogを有効化するPORTAGE_ELOG_CLASSES="log" PORTAGE_ELOG_SYSTEM="save"
これは elog メッセージを保存する唯一の方法です。Portage の elog システムがどのように動作するかについての詳細は Portage Handbook 内の適切なページを参照してください。
elog を思うように設定できたら、eread を実行してログファイルを表示します。
user $ereadThis is a list of portage log items. Choose a number to view that file or type q to quit. 1) app-portage:gentoolkit-0.2.4_pre2:20070320-000256.log 2) app-portage:gentoolkit-0.2.4_pre2:20070320-000258.log 3) app-portage:gentoolkit-0.2.4_pre2:20070320-000319.log 4) app-portage:gentoolkit-0.2.3:20070320-000408.log Choice?
番号を選択すると PAGER 環境変数で指定されているページングプログラムを使用してファイルが表示されます。PAGER がセットされていない場合には less が使用されます。PAGER 環境変数は eselect (pager モジュール)を使用してセットできます。
elog アイテムを表示した後、ファイルを削除するかどうか尋ねられます。
eclean
eclean は古いソースファイルや古いバイナリパッケージをシステムから削除するツールです。
パッケージをビルド・インストールする際にはソースファイルがダウンロードされ DISTDIR 、通常は /usr/portage/distfiles に保存されます。これらは、定期的に掃除しないと時間とともに数ギガバイトのデータが蓄積してしまうこともあります。ユーザーは、eclean-distを実行して DISTDIR のソースファイルをクリーンアップする必要があります。
quickpkg や FEATURES="buildpkg" を使用してインストール済みパッケージのアーカイブを作成することができます。それらのアーカイブされたパッケージは PKGDIR、通常は /usr/portage/packages に保管されます。それらがもはや不要になったり古すぎたりする場合、eclean-pkg を実行してそれらを PKGDIR から削除することができます。システムにあるすべてのバイナリパッケージは最新のバージョンのみにしておくのがよいでしょう。
eclean についての詳細や不要なデータのないシステムを維持するための豆知識については、man eclean を読むか、eclean の記事を参照してください。
参考
This page is based on a document formerly found on our main website gentoo.org.
The following people contributed to the original document: Matt Butcher, John P. Davis, Erwin, Shyam Mani, Xavier Neys, Karl Trygve, José Luis Rivero, Joshua Saddler, Douglas Anderson
They are listed here because wiki history does not allow for any external attribution. If you edit the wiki article, please do not add yourself here; your contributions are recorded on each article's associated history page.