Provided by: paco_2.0.9-1_i386 bug

NAME

       paco - a source code package organizer

SYNOPSIS

       paco [OPTIONS] <packages>
       paco -l [OPTIONS] <package> <command>
       paco -q <files>

DESCRIPTION

       Paco  is  a  program to aid package management when installing packages
       from source code.

       When installing a package, paco can be used in log  mode  (with  option
       -l) to wrap the installation command (e.g. "make install"), and log the
       created  files.  By  default   the   log   is   stored   in   directory
       '/var/log/paco'.

       Once  some packages are installed and properly logged, paco can be used
       in list mode, which is the default,  to  display  package  information.
       Several  options  are  provided  to  print the information in different
       formats.

       There are also options to remove  packages,  query  for  the  owner  of
       files, or maintain the package database.

       Mandatory  arguments  to  long  options are mandatory for short options
       too.

       The special option --  forces  and  end  of  option-scanning.  This  is
       specially useful when entering the install command in log mode.

GENERAL OPTIONS

       -a, --all
              Apply  the specified action to all logged packages. This doesn't
              work with option -r.

       -h, --help
              Display a help message and exit.

       -L, --logdir=DIR
              Base log directory. Default is '/var/log/paco', unless  variable
              LOGDIR  is  set in the configuration file (type 'man pacorc' for
              more information).

       -v, --verbose
              Verbose  output.  -vv  prints  also  debugging  messages   (only
              meaningful with option -l).

       --version
              Display version information and exit.

DATABASE MAINTENANCE OPTIONS

       -u, --update
              Synchronize  the  log  of the package with the current status of
              the filesystem, calculating the size of  the  logged  files  and
              checking whether they are missing.  If a file becomes compressed
              or uncompressed (with bzip2 or gzip), it is  detected  as  well.
              Use along with -a to update the whole database.

       -U, --unlog
              Remove the log of the package from the database.

GENERAL LIST OPTIONS

       -b, --block-size=SIZE
              Use  blocks of SIZE bytes for the sizes. SIZE may be an integer,
              optionally followed by one of the following: k, K, m, M.

       -k, --kilobytes
              Like '--block-size=1k', or '--block-size=1024'.

       --sort=WORD
              Sort the list by WORD: When listing files, meaningful values for
              WORD  are: 'name' and 'size'. When listing packages, WORD may be
              also: 'date' (or 'time'), 'files', 'missing-files' or  'missing-
              size'.

       -R, --reverse
              Reverse order while sorting.

       -t, --total
              Print totals at the bottom of the list.

PACKAGE LIST OPTIONS

       -1, --one-column
              List one package per line.

       -F     Print the number of installed files.

       -M     Print the number of missing files.

       -C     Print the number of shared files (both installed and missing).

       -d, --date
              Show installation date (-dd shows the hour too).

       -s, --size
              Show  the  currently  installed  size  of each package; in human
              readable format by default (e.g. 1.2M, 13k).

       -n, --missing-size
              Print the missing size  of  each  package  (=  original  size  -
              current size).

FILE LIST OPTIONS

       -f, --files
              List currently installed files of the package.

       -m, --missing-files
              List  missing  files (those files removed after the installation
              of the package).  -f and -m options can be used together.

       -c, --shared
              With -f and/or -m, list only the shared files (those files  also
              logged by other packages).

       -N, --non-shared
              With  -f  and/or -m, list only the non shared files (those files
              not logged by any other package).

       -w, --who-shares
              With -c, print the names of the packages that share each file.

       -y, --symlinks
              Print the contents of symbolic links.

       -s, --size
              Print the size of each file; in human readable format by default
              (e.g. 1.2M, 13k).

       -z, --no-package-name
              Do not print the name of the package. Useful for scripts.

INFORMATION OPTIONS

       Note: Information may be not available for all packages.

       -i, --info
              Print package information.

       -o, --configure-options
              Print the configure options the package was built with.

       -q, --query, --owner
              Query for the packages that own one or more files.

LOG OPTIONS

       -l, --log
              Enable  log  mode:  If  a shell command is given as an argument,
              execute and monitor it, logging the created files, otherwise the
              list of files to log is read from the standard input.
              The  list  of  logged  files  is printed to the standard output,
              unless any of -p or -D options is used, in which case is assumed
              that a package is to be logged in the paco database.
              When  a  shell comand is monitorized, paco returns the exit code
              of that command.
              See EXAMPLES below.

       -p, --package=PKG
              Specify the name of the package to log, which must begin with an
              alphanumeric  character.  With  -v,  the list of logged files is
              also printed to the standard error stream. With -vv, paco prints
              detailed  information  about the install process. This holds for
              option -D too.

       -D, --dirname
              Use the name of the current directory as the name of the package
              to be logged.

       -E, --exclude=PATH1:PATH2:...
              Colon-separated  list  of paths to skip when logging. Default is
              '/dev:/tmp:/usr/src:/media:/selinux:/sys:/usr/share/info/dir',
              unless  variable  EXCLUDE is set in the configuration file (type
              'man pacorc' for more information).
              Shell wildcards are allowed in  the  PATHs.  See  PATH  MATCHING
              below for more details.

       -I, --include=PATH1:PATH2:...
              Colon-separated  list  of paths to scan when logging. Default is
              '/', unless variable INCLUDE is set in  the  configuration  file
              (type 'man pacorc' for more information).
              Shell  wildcards  are  allowed  in  the PATHs. See PATH MATCHING
              below for more details.

       --ignore-errors
              Do not exit if  the  install  command  fails.  This  allows  for
              logging uncomplete installations, and cleanup the system upon an
              installation failure. Errors are not ignored by default,  unless
              variable LOG_IGNORE_ERRORS is set to 1 in the configuration file
              (type 'man pacorc' for more information).

       --log-missing
              Log also the missing files (they are skipped  by  default).  See
              EXAMPLES below.

       -+, --append
              With -p or -D, if the package is already logged, append the list
              of files to its log.

REMOVE OPTIONS

       -r, --remove
              Remove a package,  keeping  the  shared  files  and  asking  for
              confirmation  by  default. Compressed files (with gzip or bzip2)
              are also removed. If the option is doubled (-rr), or all  logged
              files  are successfully removed, the package is removed from the
              database.

       -B, --batch
              Don't prompt for confirmation when removing (and assume  yes  to
              all questions).

       -e, --skip=PATH1:PATH2:...
              Don't remove files in these paths.
              Shell  wildcards  are  allowed  in  the PATHs. See PATH MATCHING
              below for more details.

       --remove-shared
              Remove also the shared files.

PATH MATCHING

       Options -I, -E and -e accept a colon-separated list of paths,  each  of
       which  may  contain  shell-like  wildcards  (*, ? and [..]).  Files are
       matched against each of those paths, following the standard  shell-like
       expansion, but with the following exception: If a path in the list does
       not contain any wildcard, and it is a directory, it  matches  any  file
       within that directory.
       Note  that if wildcards are to be used, the whole list of paths must be
       enclosed in single quotes (') to protect it from being expanded by  the
       shell.

EXAMPLES

       To  log  the  installation of the package 'foo-1.0', which is installed
       with the command 'make -C src install':

           paco -lp foo-1.0 "make -C src install"

       Note that in this example the quotes are required to  prevent  paco  to
       treat '-C' as a command line option.
       Use single quotes if the command already contains double quotes:

            paco -lp foo-1.0 'echo "hello world" > /var/log/foo.log'

       The  special  end-of-option  argument  '--'  may  be  used for the same
       purpose:

           paco -lp foo-1.0 -- make -C src install

       Alternatively, we can use the basename of the current directory as  the
       name of the package to log, using the option -D instead of -p:

           paco -lD "make install && make install.man"

       If we have forgotten to install a file, it can be added to a previously
       created log with the option -+:

           paco -lp+ foo-1.0 "install foo /bin/foo"

       Note that the option -+ cannot be used to remove a file from  the  log.
       For instance, the following command:

           paco -lp+ foo-1.0 "rm /bin/foo"

       would not unlog the file /bin/foo from the log of foo-1.0, but it would
       mark it as missing instead.

       To avoid such behaviour it is sometimes  useful  to  join  up  composed
       install  commands  into  one  single  command  and  run  paco once. For
       instance, imagine that a package installs the  file  /bin/foo,  but  we
       want it to be installed in /usr/bin/foo. If one runs this:

           paco -lp foo-1.0 make install
           paco -lp+ foo-1.0 "mv /bin/foo /usr/bin/foo"

       Both  files,  /bin/foo and /usr/bin/foo remain in the log. /usr/bin/foo
       is marked as installed, and /bin/foo is  marked  as  missing.  This  is
       usually not the desired behaviour. As a workaround one can join up both
       commands in one single paco run:

           paco -lp foo-1.0 "make install && mv /bin/foo /usr/bin/foo"

       In this case only /usr/bin/foo is logged.

       The understand the meaning of the option  --log-missing,  consider  the
       following example, where the file /foo/bar does not exist:

           echo /foo/bar | paco --log-missing -lp foo

       This  would  log  the file /foo/bar, even if it is missing. Without the
       option --log-missing /foo/bar is skipped.

       To remove all versions of the package foo, keeping the  files  in  /etc
       and /root, and without asking for confirmation:

           paco -r --batch -e /etc:/root foo

       To  remove  the  package foo-3.3, keeping the files in /var/log and the
       files ending with ".conf":

           paco -r -e '/var/log:*.conf' foo-3.3

       We have installed the package 'bubble-1.9' in prefix '/opt/bubble-1.9',
       but  we  haven't  logged  the  installation with paco. No problem! Just
       create a log for it thusly:

           find /opt/bubble-1.9 | paco -lp bubble-1.9

BUGS

       Due to LD_PRELOAD limitations, paco can't  follow  the  trace  of  suid
       programs.
       For  the  same reason, paco does not work with programs that statically
       link libc.

FILES

       /etc/pacorc - configuration file
       /var/log/paco - default log directory

WEB SITE

       The latest version of paco should be always available at:
            http://paco.sourceforge.net

COPYRIGHT

       Copyright (C) 2004-2009 David Rosal <davidrr@sourceforge.net>
       This is free software; see the source for copying conditions.  There is
       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE.

SEE ALSO

       pacorc(5), pacoball(8), superpaco(8), rpm2paco(8)