Gentoolkit/de

Gentoolkit ist eine Suite von Werkzeugen zur Erleichterung der Administration eines Gentoo Systems. Dieses Dokument beschreibt die Grundlagen einiger dieser in Gentoolkit vorhandenen Tools.

Was ist Gentoolkit?
Gentoo ist eine einzigartige Distribution und zeigt einige Komplexitäten, die es bei anderen Distributionen einfach so nicht gibt. Als Gentoo-Entwickler und Mitwirkende einige dieser Komplexitäten aufdeckten, schrieben Sie Tools um den Benutzern und Administratoren zu helfen diese zu umgehen. Viele dieser Tools wurden dem Gentoo-Projekt beigesteuert und sind im Paket enthalten.

Gentoolkit enthält eine ganze Reihe nützlicher Tools die helfen, Ihre Pakete zu verwalten und im Auge zu behalten was auf Ihrem System los ist. Die meisten Nutzer -- insbesondere jene, die Systeme oft aktualisieren -- werden von der gentoolkit-Installation profitieren.

Installation
Genau wie bei jedem anderen Gentoo Paket ist die Installation ein einfaches emerge.

Dokumentation finden
Jegliche Dokumentation die ein Programm haben könnte (außer den Manpages), ist abgelegt in.

Einleitung
ist ein Tool das nützliche Informationen über die Pakete auf Ihrem System anzeigt. code>equery basiert auf einem System von Modulen. Jedes Modul hat ein Namenskürzel. Beispielsweise ist  das Gleiche wie. erläutert globale Optionen und listet alle verfügbaren Module und deren Namenskürzel auf. zeigt die Hilfe zu einem bestimmten modul. Letztendlich bietet  eine detaillierte Erklärung aller verfügbaren Module deren Optionen und zeigt darüber hinaus nützliche Beispiele.

Es folgt eine Liste von Funktionen, die bei der Mehrzahl der Module funktionieren.

Genauso wie emerge versteht equery keine teilweise angegebenen Paketnamen:

Anders als emerge akzeptiert equery Shell-ähnliche Platzhalter in der Kategorie und/oder dem Paketnamen:

Die meisten equery Module akzeptieren Mehrfacheingaben:

Ein paar wenige Module erlauben ebenfalls Reguläre Ausdrücke (regular expressions):

Die folgenden Abschnitte dieses Dokuments geben eine kurze Einführung in die unterschiedlichen  Module.

Nach dem Paket suchen aus dem eine bestimmte Datei kam - belongs (b)
kann mit der Option  nach Dateien suchen, die zu einem Regulären Ausdruck (regex) passen. Die Option  beendet die Suche nach der ersten Fundstelle. Weil keine Datei auf Ihrem System zu zwei Paketen gehören sollte, ist dies eine sichere Optimierung.

Change Log Einträge betrachten - changes (c)
erlaubt es Ihnen Change Log Einträge einer bestimmten Paketversion, oder eines Bereichs von Versionen zu betrachten. Stellen Sie sich vor, dass Portage nach einem  ein Upgrade durchführen möchte und Sie überprüfen wollen, was sich geändert hat:

Paket-Integrität überprüfen - check (k)
Manchmal ist es sinnvoll die Integrität eines Paketes zu überprüfen. kann sowohl MD5-Summen als auch Zeitstempel überprüfen um anzuzeigen ob ein Paket möglicherweise beschädigt, ausgetauscht oder entfernt wurde.

Alle Pakete auflisten die von Paket X abhängen - depends (d)
Haben Sie sich jemals gefragt, warum ein bestimmtes Paket auf Ihrem System installiert wurde? kann Ihnen mit  die Frage der Abhängigkeiten beantworten. Indirekte Abhängigkeiten werden mit der Option  eingeschlossen.

Abhängigkeits-Graphen abfragen - depgraph (g)
ist das Gegenteil von. Sie geben ihm ein Paket und es findet die Pakete von denen es abhängt (nicht die von ihm abhängen). Wenn es eine Abhängigkeit findet, wird es rekursiv nach allen diesen Paket-Abhängigkeiten suchen. Kontrollieren Sie mit der Option, wie tief der Baum der Abhängigkeiten wird.

Beachten Sie, dass  direkt abhängig wohingegen   indirekt abhängig ist, wenn das   USE Flag gesetzt ist.

Dateien auflisten die von einem Paket installiert wurden - files (f)
kann mit dem Modul  alle Dateien auflisten, die von einem bestimmten ebuild installiert wurden. Versuchen Sie, um eine leicht zu lesende Ausgabe im Verzeichnis-Layout zu erhalten. Verwenden Sie, um nur einen bestimmten Dateityp zu finden. Um beispielsweise herauszubekommen wo die ausführbaren Dateien installiert wurden, verwenden Sie. Um schnell den Konfigurationsdatei-Speicherort zu finden nutzen Sie.

Nach Paketen suchen die ein bestimmtes USE Flag haben - hasuse (h)
Sie können  nutzen um herauszufinden welche Pakete ein angegebenes USE Flag haben. wird Ihnen nicht angeben ob das Flag aktiviert ist, sondern nur ob das ebuild es als Option auflistet. Siehe EXAMPLES Abschnitt von  in der   Manpage für mehr Tipps.

Pakete auflisten - list (l)
ist ein einfaches aber dennoch mächtiges Modul, um installierte Pakete aus dem Portage-Baum oder eines Overlays aufzulisten.

Die Standardabfrage sucht installierte Pakete zum angegebenen Paketnamen. Die Eingabe von '*' zeigt alle Pakete des Satzes an. Im äußersten linken Feld sehen wir, dass alle obigen Pakete (nstalliert) und vom  (ortage) Baum stammen. Sie sind nicht maskiert (das zweite Feld ist leer) und alle im Default Slot (0) installiert.

Dieses mal werden wir lokale Optionen nutzen, um nach Paketen im Portage Baum und in Overlays zu suchen.

In diesem Beispiel können Sie sehen, dass Version 7.2.182 installiert ist und dass keine Versionen aus einem Overlay verfügbar sind. Durch  im zweiten Feld erkennt man, welche Versionen durch ein Schlüsselwort maskiert sind.

Paket Metadaten anzeigen - meta (m)
Jedes Paket im Portage Baum bietet zumindest einige Metadaten über seinen Betreuer (maintainer), herd, etc. Nachzulesen unter Gentoo Metadata (englisch). Die Menge nützlicher Informationen hängt davon ab, wie viele Paketbetreuer sich einbringen. Ohne Optionen liefert  einige grundlegende nützliche Informationen.

Wenn der Betreuer zusätzliche Informationen anbietet, kann es sehr nützlich sein:

Paketgrößen herausbekommen - size (s)
Haben Sie jemals ernsthaft versucht herauszubekommen wie viel Platz ein bestimmtes Paket belegt? Weil ein Paket seine Dateien über eine ganze Menge von Verzeichnissen verteilen kann, verschafft Ihnen das gebräuchliche  möglicherweise nicht den richtigen Eindruck. Keine Sorge, hier kommt  als Rettung.

As you can see,  prints the total space used in human-readable units and lists the total number of files the package has. To get the total size in bytes, use.

Listing Per-Package USE Flags with uses (u)
's  module can provide information about what USE flags are available for a specific package, and which of those flags is currently enabled.

Here, a number of USE flags are enabled in 's plugin meta-package, but you can see that there are other USE flags available. For more information on USE flags, please refer to the USE Flags chapter of the Gentoo Handbook.

Finding the Ebuild Path with which (w)
is a simple script to help you quickly find the file path to an ebuild. If you pass an unversioned package name,  will return the path to the newest installable ebuild version, in other words, the ebuild Portage would use if you typed. Pass in a versioned package to get the path to that ebuild.

Lastly, if none of the above features of  have answered your question, try using   to manually search an ebuild with programs like ,   or  :

Introduction
is a tool to see, set and unset USE flags at various places. For more information on USE flags, please refer to the USE Flags. Please see  for complete help and all options.

Viewing, Setting and Unsetting USE Flags
The  command reads the current active USE flags and displays them.

Similarly you can use the  command to only view active global USE flags. The  command does the same for active local USE flags. and  are suboptions to   and need an option before them (like  ) to function correctly.

We can also use  to set or unset use flags. The commands used for this are  (enable a flag) and   (disable a flag).

Enabling a USE Flag:

The file looks like so after the command was ran:

Disabling the USE Flag:

Again, the file after the command:

revdep-rebuild
This tool is Gentoo's Reverse Dependency rebuilder. It will scan your installed ebuilds to find packages that have become broken as a result of an upgrade of a package they depend on. It can emerge those packages for you but it can also happen that a given package does not work any more with the currently installed dependencies, in which case you should upgrade the broken package to a more recent version. revdep-rebuild will pass flags to emerge which lets you use the  flag to see what is going to be emerged again before you go any further.

If you need to rebuild some packages, you may run  without the   flag and the listed packages will be emerged again.

glsa-check
is mainly a test tool that keeps track of the various GLSA's (Gentoo Linux Security Advisory) and will eventually be integrated into  and.

eread
is a simple utility to display elog files produced by >=. You can set the saving of elog files by setting a couple of variables in :

Once you've set up elog to your satisfaction, just run  to view your log files.

Select a number and the file will be displayed using the paging program specified in the PAGER environment variable. If PAGER is not set, it will use. The PAGER environmental variable can be set using  (module  ).

After displaying the elog item, you will be prompted if you want to delete the file.

eclean
is a tool to remove old source files and old binary packages from your system.

When you build and install packages, the source files are downloaded and preserved in DISTDIR, usually. This can accumulate several gigabytes of material over time if you don't clean it periodically. You can run  to clean only source files from DISTDIR.

You can create archives of installed packages by using  or FEATURES="buildpkg". These archived packages are kept in PKGDIR, usually. When you no longer need to keep them around, or if they're too old, you can run  to remove them from PKGDIR. It's a good way to ensure that any binary packages you have are only the latest versions.

For more information on  and tips on maintaining a cruft-free system, please read   or check the eclean article.