Gentoolkit

From Gentoo Wiki
Jump to:navigation Jump to:search
This page is a translated version of the page Gentoolkit and the translation is 45% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎português do Brasil • ‎русский • ‎中文(中国大陆)‎ • ‎日本語 • ‎한국어

Not to be confused with Genkernel.

Resources

Gentoolkit は、Gentoo のシステムの管理を容易にするためのツールセットです。この文書は、 Gentoolkit にあるいくつかのツールについての基本的部分を述べています。

Gentooはユニークなディストリビューションであり、他のディストリビューションには全然存在しないような複雑なところがあります。Gentooの開発者や貢献者はそうした複雑さを見つけると、それらに対処するユーザーや管理者を補助するためのツールを作成しました。多くのツールが Gentoo Project に寄贈され、 app-portage/gentoolkit に含まれています。

Gentoolkit は、ユーザーのパッケージ管理や彼らのシステムで起こっている事の追跡を補助するための有用なツールを非常にたくさん含んでいます。多くのユーザー - 特にシステムをしばしばアップデートするユーザー - は Gentoolkit をインストールしておくことで恩恵を受けるでしょう。

The Gentoolkit commands have man pages, type "man <command>" for each command for full documentation.

インストール

Emerge

root #emerge --ask app-portage/gentoolkit

euse

euse is used to set (disable/enable) USE flags in make.conf, without having to edit the file directly. It is also used to get detailed information about use flags like description, status of flags (enabled/disabled), type of flag (global/local), etc.

euse は様々な場所のUSEフラグを見たり、セット・アンセットするためのツールです。USEフラグの詳細については USE Flags を参照してください。完全なヘルプとすべてのオプションについては euse -h をご覧ください。

Invocation

user $euse --help
euse (0.5.1-r1)
 
Syntax: euse <option> [suboptions] [useflaglist]
 
Options: -h, --help           - show this message
         -V, --version        - show version information
         -i, --info           - show descriptions for the given useflags
         -I, --info-installed - show descriptions for the given useflags and
                                their current impact on the installed system
         -g, --global         - show only global use flags (suboption)
         -l, --local          - show only local use flags (suboption)
         -a, --active         - show currently active useflags and their origin
         -E, --enable         - enable the given useflags
         -D, --disable        - disable the given useflags
         -R, --remove         - remove all references to the given flags from
                                make.conf and package.use to revert to default
                                settings
         -P, --prune          - alias for --remove
         -p, --package        - used with -E, -D, and -R to apply to a
                                specific package only
 
Notes: euse currently works for global flags defined
       in make.globals, make.defaults, make.conf, use.force, and use.mask
       and local flags defined in package.use and individual package ebuilds.
       It might have issues with cascaded profiles. If multiple options are
       specified only the last one will be used.
Note
The information provided by euse --help is currently out of date[1]. (2021-10)

USEフラグを表示、セット、アンセットする

euse -a コマンドは現在有効なUSEフラグを読み込んで表示します。

Note
現在、euse はフラグがセットされているか否か、またフラグがセットされているすべての場所を表示するために5つの行を使用します。各行は以下のとおりです -- +/-、Environmentでセットされているか、make.Confでセットされているか、make.Defaultsでセットされれているか、make.Globalsでセットされているか。出力は[+ECDG]のようになります。


Full positive values would be [+ECDGFm], full negative values would be [-ecdgfM], full missing values would be [-      ].

Example euse -a output (truncated):

user $euse -a
X                   [+ 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-leuse のサブオプションであり、正しく動作するにはこれらの前に(-aのような)オプションが必要です。

Setting, and unsetting USE flags

euse はUSEフラグをセットまたはアンセットすることができます。このために使われるコマンドは euse -E flagname (フラグを有効化) および euse -D flagname (フラグを無効化)です。

Warning
euse -Eeuse -D コマンドそれ自体を(フラグなしで)使用してはいけません。 /etc/portage/make.conf 内ですべてのUSEフラグをセット/アンセットしてしまいます。バックアップが /etc/portage/make.conf.euse_backup に保存されはしますが、euse -Eeuse -D を使用する際は注意を払ってください!

USEフラグを有効化する:

Use the -E option to enable a USE flag.

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 ファイルはこのようになります:

FILE 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フラグを無効化する:

Use the -D option to remove a USE flag.

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:

FILE 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"
Note
euse はフラグを /etc/portage/make.conf から物理的に除去しません。euse- (マイナス) をフラグの前に追加してフラグをアンセットします。不要な変数を避けるため、/etc/portage/make.conf を手動でクリーンアップする必要があるかもしれません。あるいは、-P (purge)オプションを使用してフラグを取り除きます。たとえば、euse -P 3dfx3dfx フラグを取り除きます。
Tip
A disabled USE flag is not the same as the absence of the flag in make.conf. A disabled use flag will actively disable features, whereas not listing a flag at all will use the default - enabled or disabled - as set by the package maintainer.

Remove (prune) a USE flag

Use the -P (purge) option to remove a USE flag.

root #euse -P 3dfx

The example /etc/portage/make.conf file, after the command:

FILE make.confAfter disabling the 3dfx USE flag
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"

そのほかのツール

revdep-rebuild

Important
このツールを、一般的用途のために実行する必要はありません。Portageの機能であるpreserve-libsによって、元々の目的はもはや時代遅れのものとなっています。今のこのツールの主な目的は、開発者が実行手順を提示した場合の特定のライブラリのためのABIの変更です。

このツールはGentooのリバース依存関係を再構築します。これは依存パッケージの更新の結果壊れたパッケージを探すため、インストールされている ebuild をスキャンします。それらのパッケージをユーザーのために自動的にemergeすることもできますが、一定のパッケージは現在インストールされている依存関係の下では正しく動作しないこともあり、こうした場合にはその壊れたパッケージをより最近のバージョンにアップグレードしなければなりません。revdep-rebuild はフラグを emerge に渡すので、--pretend フラグを使用して何が再度emergeされるのか事前に確認することができます。

revdep-rebuild will pass flags to emerge which lets the --pretend flag pass through, to see what is going to be emerged again before going any further.

user $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されます。

eread

eread はバージョン2.1以降の Portage によって生成されるelogファイルを表示するシンプルなユーティリティーです。elogファイルの保存は、2つの変数を /etc/portage/make.conf でセットすることで有効化できます:

FILE make.confelogを有効化する
PORTAGE_ELOG_CLASSES="log"
PORTAGE_ELOG_SYSTEM="save"
Note
これは elog メッセージを保存する唯一の方法です。Portage の elog システムがどのように動作するかについての詳細は Portage Handbook 内の適切なページを参照してください。

elog を思うように設定できたら、eread を実行してログファイルを表示します。

user $eread
This 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 、通常は /var/cache/distfiles に保存されます。これらは、定期的に掃除しないと時間とともに数ギガバイトのデータが蓄積してしまうこともあります。ユーザーは、eclean-distを実行して DISTDIR のソースファイルをクリーンアップする必要があります。

quickpkgFEATURES="buildpkg" を使用してインストール済みパッケージのアーカイブを作成することができます。それらのアーカイブされたパッケージは PKGDIR、通常は /var/cache/binpkgs に保管されます。それらがもはや不要になったり古すぎたりする場合、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.