Provided by: porg_0.10-1.1_amd64 
NAME
porg - a source code package organizer
SYNOPSIS
porg [OPTIONS] <packages>
porg -l [OPTIONS] <package> <command>
porg -q <files>
DESCRIPTION
Porg is a program to aid package management when installing packages from source code.
When installing a package, porg may be used in log mode (with option -l) to wrap the installation command
(e.g. "make install"), and log the created files into a text database.
Porg also provides options for printing package information, package files, removing packages or querying
for the owner of files.
The special option '--' forces and end of option-scanning. This is specially useful when entering the
install command in log mode.
Mandatory arguments to long options are mandatory to short options too.
GENERAL OPTIONS
-a, --all
Apply to all installed packages (not with -r).
-L, --logdir=DIR
Base log directory. The logs for the installed packages are saved in this directory. Default is
'/var/lib/porg', unless variable LOGDIR is set in the configuration file (type 'man porgrc' for
more information).
-v, --verbose
Verbose output. -vv prints also debugging messages.
-x, --exact-version
Disable expansion of package version (not with -l).
By default, porg automatically expands the package names given as arguments, by adding all the
versions of the package that are registered in the porg database. For instance, if foo-1.0 and
foo-2.0 are installed, the command 'porg -r foo' would remove both packages, and 'porg -r foo-1'
would remove only foo-1.0.
The option -x inhibits this expansion, so that package names must match the basename and the whole
version of a registered package.
-h, --help
Display a help message and exit.
-V, --version
Display version information and exit.
GENERAL LIST OPTIONS
These options can be used to list packages or files.
-R, --reverse
Reverse order while sorting.
-t, --total
Print totals at the bottom of the list, when appliable. When printing total sizes, the sizes of
hardlinks to installed files are counted only once.
-z, --no-package-name
Do not print the name of the package when listing. Useful for scripts.
PACKAGE LIST OPTIONS
-s, --size
Print the installed size of the package. Sizes of hardlinks to installed files are counted only
once.
-F, --nfiles
Print the number of installed files.
-d, --date
Print the installation date of the package. Double it ('-dd') to print also the hour.
-S, --sort=WORD
Sort the list by WORD: 'name', 'size', 'files' or 'date'.
FILE LIST OPTIONS
-f, --files
List the files installed by the package.
-s, --size
Print the size of each file.
-y, --symlinks
Print the contents of symbolic links.
-S, --sort=WORD
Sort the list by WORD: 'name' or 'size'.
PACKAGE INFORMATION OPTIONS
Only one of these options may be used at once.
-i, --info
Print package information (like summary, author, URL...), if available.
-o, --configure-options
Print the arguments (command line options and environment variables) passed to the 'configure'
script when the package was built.
-q, --query
Query for the packages that own the files specified as arguments.
PACKAGE LOG OPTIONS
-l, --log
Enable log mode. If a shell command is given as argument, execute and monitor it, logging the
created files; otherwise the list of files to be logged is read from the standard input. In either
case, the relative paths are automatically resolved.
The list of logged files is printed to the standard output, unless any of -p or -D options is
used, in which case it is assumed that a package is to be registered into the porg database.
See EXAMPLES and FILE NAMES WITH SPACES below.
-p, --package=PKG
Specify the name of the package to be logged. With -v, the list of logged files is also printed to
the standard error stream. With -vv, porg 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 the installed files. Default is
'/tmp:/dev:/proc:/sys:/run', unless variable exclude is set in the configuration file (type 'man
porgrc' 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 the installed files. Default is '/', unless
variable include is set in the configuration file (type 'man porgrc' for more information).
Shell wildcards are allowed in the PATHs. See PATH MATCHING below for more details.
-j, --log-missing
By default, when installing a package porg registers only those files that exist in the filesystem
right after the installation. With this option porg registers also the missing files.
-+, --append
With -p or -D, if the package is already registered, append the list of created files to its log.
PACKAGE REMOVE OPTIONS
-r, --remove
Remove a package, keeping the shared files and asking for confirmation by default.
-U, --unlog
Unregister the package from the database, without removing any file.
-b, --batch
Don't prompt for confirmation when removing or unlogging (and assume yes to all questions).
-e, --skip=PATH1:PATH2:...
Colon-separated list of paths to skip when removing a package. Default is '' (all logged files are
removed), unless variable remove_skip is set in the configuration file (type 'man porgrc' for more
information).
Shell wildcards are allowed in the PATHs. See PATH MATCHING for more details.
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.
FILE NAMES WITH SPACES
As of version 0.3, porg accepts filenames with spaces when logging package installations. Although IMHO
this should be seen as an improvement in general terms, it may cause problems when trying to feed 'porg
-l' with a list of files separated by spaces. For example, the following command:
echo /bin/foo /bin/bar | porg -l
would try to log the file "/bin/foo /bin/bar" instead of logging /bin/foo and /bin/bar separately. To fix
this, one may use newlines to separate file names, and pass option -e to echo so it honours escape
characters, like this:
echo -e "/bin/foo\n/bin/bar" | porg -l
or either write the list of files separated by newlines into a temporary file, and run:
cat tmpfile | porg -l
EXAMPLES
To log the installation of the package 'foo-1.0', which is installed with the command 'make -C src
install':
porg -lp foo-1.0 "make -C src install"
Note that in this example the quotes are required to prevent porg to consider '-C' as a command line
option. The special end-of-option argument '--' may be used for the same purpose:
porg -lp foo-1.0 -- make -C src install
Use single quotes if the command already contains double quotes:
porg -lp foo-1.0 'echo "hello world" > /var/log/foo.log'
Alternatively, we can use the basename of the current directory as the name of the package to be logged,
using the option -D instead of -p:
porg -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 -+:
porg -lp+ foo-1.0 "install bar /bin/bar"
Note that the option -+ cannot be used to remove a file from the log. For instance, the following
command:
porg -lp+ foo-1.0 "rm /bin/bar"
would not remove the file /bin/bar from the log of foo-1.0.
To avoid such behaviour it is sometimes useful to join up composed install commands into one single
command and run porg once. For instance, imagine that a package installs the file /bin/bar, but we want
it to be installed in /usr/bin/bar instead. If one runs this:
porg -lp foo-1.0 make install
porg -lp+ foo-1.0 "mv /bin/bar /usr/bin/bar"
Both files, /bin/bar and /usr/bin/bar remain in the log. This is usually not the desired behaviour. As a
workaround one can join up both commands in one single porg run:
porg -lp foo-1.0 "make install && mv /bin/bar /usr/bin/bar"
In this case only /usr/bin/bar is logged.
To remove the package foo-3.3, keeping the files in /etc and the files ending with ".conf":
porg -r -e '/etc:*.conf' foo-3.3
You have installed the package 'boo-1.9' in prefix '/opt/boo-1.9', but you haven't logged the
installation with porg. No problem! Just create a log for it thusly:
find /opt/boo-1.9 | porg -lp boo-1.9
By the way, porg internally converts all package names to lower case; 'FooBar' and 'foobar' are the same
package.
BUGS
Due to LD_PRELOAD limitations, porg can't follow the trace of suid programs.
For the same reason, porg does not work with programs that statically link libc.
FILES
/etc/porgrc - configuration file
/var/lib/porg - default log directory
AUTHOR
Written by David Ricart (http://porg.sourceforge.net)
SEE ALSO
porgrc(5), porgball(8)