diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml index 1b5978e7c9..2719ef1ee0 100644 --- a/documentation/ref-manual/usingpoky.xml +++ b/documentation/ref-manual/usingpoky.xml @@ -248,6 +248,84 @@ +
+ Viewing Package Information with <filename>oe-pkgdata-util</filename> + + + You can use the oe-pkgdata-util command-line + utility to query + PKGDATA_DIR + and display various package-related information. + When you use the utility, you must use it to view information + on packages that have already been built. + + + + Following are a few of the available + oe-pkgdata-util subcommands. + + You can use the standard * and ? globbing wildcards as part of + package names and paths. + + + + oe-pkgdata-util list-pkgs [pattern]: + Lists all packages that have been built, optionally + limiting the match to packages that match + pattern. + + + oe-pkgdata-util list-pkg-files package ...: + Lists the files and directories contained in the given + packages. + + + A different way to view the contents of a package is + to look at the + ${WORKDIR}/packages-split + directory of the recipe that generates the + package. + This directory is created by the + do_package + task and has one subdirectory for each package the + recipe generates, which contains the files stored in + that package. + + If you want to inspect the + ${WORKDIR}/packages-split directory, + make sure that you are not running with + rm_work + enabled when building the recipe. + + + + oe-pkgdata-util find-path path ...: + Lists the names of the packages that contain the given + paths. + For example, the following might return + make-doc: /usr/share/man/man1/make.1: + + $ oe-pkgdata-util find-path /usr/share/man/man1/make.1 + + + + oe-pkgdata-util lookup-recipe package ...: + Lists the name of the recipe that produces the given + packages. + + + + + + For more information on the oe-pkgdata-util + command, use the help facility: + + $ oe-pkgdata-util ‐‐help + $ oe-pkgdata-util subcommand --help + + +
+
Viewing Dependencies Between Recipes and Tasks