Gentoolkit/ko

Gentoolkit은 젠투 시스템을 쉽게 관리할 수 있도록 하는 도구 모음입니다. 이 문서에서는 Gentoolkit에 있는 몇가지 도구에 대한 기본 내용을 다룹니다.

Gentoolkit이란 무엇인가요?
젠투는 다른 배포판에는 단순히 나타나지 않는 복잡성이 있는 유일한 배포판입니다. 젠투 개발자 및 기여자는 이러한 복잡석을 찾아내는대로 도구를 작성하여 복잡한 환경을 사용하는 사용자 및 관리자를 돕습니다. 대부분 이러한 도구는 젠투 프로젝트에 기여하며  꾸러미에 있습니다.

Gentoolkit에는 꾸러미를 관리하는데 돕고 시스템에서 어떤 일이 일어나고 있는지 지켜볼 수 있는 쓸모있는 여러가지 도구 전체가 들어있습니다. 대부분의 사용자는 -- 시스템을 자주 업데이트 하는 일부 -- gentoolkit을 설치하면 여러가지 이익을 봅니다.

설치
젠투 꾸러미로 존재하므로, 설치는 간단하게 이머지 하면 됩니다.

문서 찾아보기
프로그램에 대한 문서는(맨 페이지가 아닌 다른 문서) 에 들어있습니다.

도입부
is a tool that displays useful information about the packages on your system. is based on a system of modules. Every module has a shorthand name. For example,  is the same as. explains global options and lists all available modules and their shorthand names. will display the help screen for a specific module. Lastly,  provides a detailed explanation of all available modules and options, and provides useful examples.

Below is a list of features that work over the majority of modules.

Like emerge, equery doesn't understand partial package names:

Unlike emerge, equery can accept shell-like globbing in the category and/or package name:

Most equery modules take multiple input:

A few modules also allow full regular expressions:

The next few sections in this document give a quick introduction to the different  modules.

belongs(b) 옵션으로 파일을 가져온 꾸러미 찾기
can search for files matching a regular expression with the option. The option stops searching after it finds a match. Since no file on your system should be owned by two packages, this is a safe optimization.

changes(c) 옵션으로 ChangeLog 항목 살펴보기
lets you view ChangeLog entries for a package version or range of versions. Imagine after an, you notice Portage is going to be upgraded and want to check what has changed:

check(k) 옵션으로 꾸러며 무결성 확인하기
Sometimes it is useful to check a package's integrity. can verify MD5 sums as well as timestamps to indicate when a package might have been corrupted, replaced, or removed.

depends(d) 옵션으로 X 꾸러미에 의존하는 모든 패키지 목록 보기
Ever wonder why a certain package has been installed on your system? can tell which packages list it as a dependency with. Include indirect dependencies with the  option.

depgraph(g) 옵션으로 의존성 그래프 가져오기
is the opposite of. You pass it a package, and it will find the packages it depends on (not that depend on it). When it finds a dependency, it will recursively search for all of that package's dependencies. Control how deep the tree gets with the  option.

Notice how  is a direct dependency and   is an indirect dependency if the   USE flag is set.

Listing Files Installed by a Package with files (f)
can list all the files installed by an ebuild with the  module. Try  to get an easy to read directory layout. Use  to only find a certain type of file. For example, to find where executables were installed, use, and to quickly find the configuration file location, try.

Looking for Packages that Have a Specific USE Flag with hasuse (h)
You can use  to find out which packages have a given USE flag. won't tell you if the flag is enabled, only if the ebuild lists it as an option. See the EXAMPLES section of  in the   man page for more tip on getting that information.

Listing Packages with list (l)
is a simple, yet powerful module to list packages that are installed, in the Portage tree or in an overlay.

The standard query will search installed packages for the given package name. Passing in '*' displays all packages in the set. In the leftmost field, we see that all the above packages are (nstalled) and from the  (ortage) tree. They're not masked (the second field is blank), and they're all installed in the default slot (0).

This time we are going to use local options to look for packages in the Portage tree and overlays.

In this example you can see version 7.2.182 is installed and there are no versions available from an overlay. You can see which versions are keyword masked by the  in the second field.

Viewing Package Metadata with meta (m)
Each package in the Portage tree provides at least some metadata about its maintainer, herd, etc. Read about Gentoo Metadata. The amount of useful information depends on how much package maintainers decide to provide. With no options,  returns some basic useful information.

When the maintainer provides extra information, it can be very useful:

Finding Package Sizes with size (s)
Have you ever been curious to find out how much space a specific package is occupying? Since a package could have its files over a number of directories, the usual  might not give you the correct figure. Not to worry, here comes  to the rescue!

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  :

도입부
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.

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * Matt Butcher
 * John P. Davis
 * Erwin
 * Shyam Mani
 * Xavier Neys
 * Karl Trygve
 * José Luis Rivero
 * Joshua Saddler
 * Douglas Anderson