pkgsrc-Users archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[ANN] pkg_status-0.10 has been released



As some of you may already know, I develop wip/pkg_status, small tool
based on pkg_summary-utils for checking status of installed packages.

Manual and samples of use are below.

============================================================
               MAJOR CHANGES IN THIS RELEASE

  New option -0 was added. If it is applied, on NetBSD, Linux, FreeBSD
  and OpenBSD, 'pkg_status -s' runs as much subprocesses as CPUs the
  computer has thus drammatically reducing total time on SMP
  systems. See PSS_SLAVES variable for changing this behaviour of
  disabling it.

  Options listed in PKG_STATUS_OPTIONS environment variable are
  automatically passed to pkg_status, e.g. -0.

  FIX: On Linux, Solaris, Interix and some other platforms xargs
  stupidly runs the specified application even if there is no any
  input. As a result pkg_status -l[RE] may fail.

  New suboption -L for option -k was added for checking that all files
  listed in REQUIRES exist.

  Documentation update, see pkg_status -h

  mktemp(1) is used for creating a temporary directory.

============================================================
                            MANUAL

pkg_status - checks the status of installed packages, for example,
compares installed packages with pkgsrc tree or pkg_summary,
find/remove automatically installed leaf packages etc.

usage:
  pkg_status -h
  pkg_status -V
  pkg_status -s [-ruaAQDp0] [ [--] pkg_info_args ]
  pkg_status -b [-ruaAQD]   [ [--] pkg_info_args ]
  pkg_status -k [-mULd]     [ [--] pkg_info_args or pkg_admin_args ]
  pkg_status -l [-rtREn]

OPTIONS:
  -h         display this help message
  -V         display version
  -r         raw output
  -D         for debugging purposes, temp files are not removed
OPTIONS common for -s and -b:
  -s         compare against pkgsrc source tree
  -b         compare against pkg_summary(5) database,
             a path to which is stored in PKG_SUMMARY environment variable
  -u         analyse packages marked as installed by user (the default, see -a)
  -a         analyse all installed packages (see -u)
  -A         by default up-to-date packages are skipped,
             with -A they are output too
  -Q         No noisy reminder about output format
OPTIONS for -s:
  -p <file>  get PKGPATHs from <file> (instead of pkg_info -QPKGPATH).
  -0         use all available CPUs for obtaining pkg_src_summary.
OPTIONS for -l:
  -l         output leaf packages installed automatically
  -t         output only PKGNAME
  -R         remove automatically installed leaf packages
  -E         the same as -R but with 'pkg_delete -A'
  -n         pass -n to pkg_delete
OPTIONS for -k:
  -m         check checksums of installed files (pkg_admin check)
  -U         check for REQUIRES/PROVIDES coherence (pkg_lint_summary -l)
  -L         check existence of files listed in REQUIRES (pkg_lint_summary -L)
  -d         check for presense of dependencies (pkg_lint_summary -d)
Environment:
   PKG_STATUS_OPTIONS - additional options passed to pkg_status
   PKG_SUMMARY      - path to pkg_summary.{txt,gx,bz2},
                      it defaults to /srv/pkgsrc_bin/CentOS/All/pkg_summary.txt
   PKG_SRC_SUMMARY_CMD - command for generating micro summary,
                      it defaults to pkg_micro_src_summary,
                      reasonable (but slower) alternative is pkg_src_summary.
   PSS_SLAVES       - If you want to use all available CPUs, i.e. run several
                      subprocesses in parallel, set this variable to +<cpu_cnt>.
                      For details, see pkg_src_summary(1). On NetBSD, FreeBSD,
                      OpenBSD, DragonFlyBSD and Linux PSS_SLAVES defaults
                      a number of available CPUs and therefore significantly
                      speeds up 'pkg_status -s'.
   PSS_TRANSPORT    - See pkg_src_summary(1)
   PSS_PPERS        - See pkg_src_summary(1)
Examples:
   pkg_status -h
   pkg_status -V

   pkg_status -s
   pkg_status -saQ0
   env PSS_SLAVES=+8 pkg_status -sra
   pkg_status -s pkg_install bmake bootstrap-mk-files
   pkg_status -s -- -K ~/pkg_distbb/var/db/pkg -a
   pkg_status -srA -- pkg_summary-utils
   env PKG_STATUS_OPTIONS=-0 pkg_status -sp /etc/interesting_pkgs.conf

   pkg_status -b
   pkg_status -bA
   pkg_status -bar

   pkg_status -lEn

   pkg_status -km
   pkg_status -kUd

-- 
Best regards, Aleksey Cheusov.


Home | Main Index | Thread Index | Old Index