pkg_summary-utils is a collection of tools designed to handle summary
files about pkgsrc (http://www.pkgsrc.org) packages, both binary
summaries (pkg_summary(5)) and source summaries.
Despite orientation on pkgsrc, most(all?) scripts are
rather universal and can be adapted for othe packaging systems.
Just a few words about the included tools.
=================================================================
A collection of utilities for manipulating pkg_summary files,
pkg_summary(5) and pkg_src_summary (the same but for pkgsrc tree).
pkg_list_all_pkgs - list (in PKGPATH form) all packages in pkgsrc tree
pkg_src_summary - create a full pkg_src_summary
for given (in PKGPATH form) packages
pkg_micro_src_summary - create a micro pkg_src_summary
for given (in PKGPATH form) packages
pkg_cmp_summary - compare two summary files, i.e. packages
are compared by their versions
pkg_digger - high-level searcher for package summaries,
pkg_online databases etc.
pkg_digger_backend - pkg_summary.txt backend for pkg_digger
pkg_update_summary - updates pkg_summary(5) by analysing the modification
time of binary packages and pkg_summary(5) file
pkg_update_src_summary - efficiently updates pkg_src_summary for all
packages in pkgsrc tree
pkg_summary4view - convert a summary file to human readable format
pkg_refresh_summary - output an information about latest/newest version
of packages
pkg_grep_summary - output summaries about packages that matches
the specified condition.
pkg_cleanup_distdir - cleanups directory with binary packages,
that is remove all binaries absent
in input summary.
pkg_uniq_summary - filters out repeated package summaries.
pkg_assignments2pkgpath - makes an ASSIGNMENTS field a part of PKGPATH
pkg_summary2bb_pkgs - outputs packages ready for bulk builds
pkg_summary2deps - extract dependencies from summary
=================================================================
Samples of usage are below.
-----
All pkgsrc packages (uses SUBDIR variable)
pkg_list_all_pkgs
-----
Analog for 'lintpkgsrc -i', but MUCH faster:
pkg_info -Q PKGPATH '*' > packages.txt
pkg_micro_src_summary < packages.txt 2>/dev/null > micro_summary.txt
pkg_info -X '*' > inst_pkgs_summary.txt
pkg_cmp_summary -p inst_pkgs_summary.txt micro_summary.txt
-----
Comparison of binary packages against pkgsrc source tree
(It is assumed that multiple versions of package may present
in pkg_summary(5)).
cd /usr/pkgsrc
cvs up
pkg_update_src_summary /usr/pkgsrc/pkg_src_summary.txt # first run is slow
pkg_update_summary /usr/pkgsrc/pkg_summary.txt
pkg_refresh_summary /usr/pkgsrc/pkg_summary.txt > newest_pkgs.txt
pkg_cmp_summary -p newest_pkgs.txt \
/usr/pkgsrc/pkg_src_summary.txt
or (only newest versions are in pkg_summary(5))
pkg_update_src_summary /usr/pkgsrc/pkg_src_summary.txt # first run is slow
pkg_update_summary -r /usr/pkgsrc/pkg_summary.txt
pkg_cmp_summary -p /usr/pkgsrc/pkg_summary.txt \
/usr/pkgsrc/pkg_src_summary.txt
-----
The same but with micro summary (much faster!)
pkg_list_all_pkgs | \
pkg_micro_src_summary > /usr/pkgsrc/pkg_micro_summary.txt
pkg_update_summary /usr/pkgsrc/pkg_summary.txt
pkg_cmp_summary -p /usr/pkgsrc/pkg_micro_summary.txt \
/usr/pkgsrc/pkg_src_summary.txt
-----
Summary for humans (looks nice but still easily parsable)
pkg_summary4view /usr/pkgsrc/pkg_src_summary.txt
or
pkg_summary4view /usr/pkgsrc/pkg_summary.txt
-----
Close to 'pkg_chk -an'
pkg_info -X '*' > packages.txt
pkg_cmp_summary -p packages.txt /path/to/simplified_pkgchk.conf
-----
Close to 'pkg_chk -usn'
pkg_info -X '*' > packages.txt
pkg_cmp_summary -p packages.txt /usr/pkgsrc/pkg_src_summary.txt |
awk '$1 !~ /^[+=]$/'
or
pkg_info -X '*' > packages.txt
pkg_cmp_summary -p packages.txt /usr/pkgsrc/pkg_micro_summary.txt |
awk '$1 !~ /^[+=]$/'
-----
Close to 'pkg_chk -ubn'
pkg_info -X '*' > packages.txt
pkg_cmp_summary -p packages.txt /usr/pkgsrc/pkg_summary.txt |
awk '$1 !~ /^[+=]$/'
NOTE: To keep pkg_src_summary.txt up-to-date it makes sense to run
pkg_update_src_summary after updating pkgsrc source tree.
-----
Are you tired of PKGSRCDIR/pkglocate, pkg_find etc.?
Try to use pkg_grep_summary like the following
pkg_grep_summary -h
pkg_grep_summary 'PKGNAME' 'fvalue ~ /judy/' \
< /usr/pkgsrc/packages/pkg_summary.txt
pkg_grep_summary 'PKGPATH' 'fvalue ~ /^lang\//' \
< /usr/pkgsrc/packages/pkg_summary.txt
pkg_grep_summary 'DEPENDS' 'fvalue ~ /libX/' \
< /usr/pkgsrc/pkg_src_summary.txt
pkg_grep_summary 'COMMENT' 'toupper(fvalue) ~ /DNS/' \
< /usr/pkgsrc/pkg_src_summary.txt
-----
In some situations the installed packages may be in inconsistent state
due to problems with required and installed shared libraries
(REQUIRES/PROVIDES fields in summary)
pkg_info -Xa | pkg_lint_summary -l
