.\"----------------------------------------------------------------
.\" pacoball.8 - pacoball-2.0.9 man page
.\"----------------------------------------------------------------
.\" Copyright (C) 2004-2009 David Rosal <davidrr@sourceforge.net>
.\" For more information visit  http://paco.sourceforge.net
.\"----------------------------------------------------------------
.\"
.TH PACOBALL "8" "28 June 2010" "paco-2.0.9" "System"
.SH NAME
pacoball - Binary package support for paco(8).
.SH SYNOPSIS
\fBpacoball\fR [-bgftv] [-d DIR] [-1..9] [-a|<packages>]
.br
\fBpacoball\fR -e [-ltv] [-C DIR] <pacoballs>
.SH DESCRIPTION
.PP
By default, \fBpacoball\fR may be given one or more
package names as arguments, and for each of those packages it creates
a binary tarball (.tar.bz2 or .tar.gz) containing all the currently
installed files. For this to work the input packages have to be
registered in the paco database.
.br
Leading slashes ('/') are stripped from the paths of the files in the
tarballs.
.PP
With option \fB\-e\fR, \fBpacoball\fR admits one or more previously
created tarballs ("pacoballs") as arguments, and installs them into the
system, optionally logging the installation with paco.
.PP
Mandatory arguments to long options are mandatory for short options too.
.SH GENERAL OPTIONS
.TP
\fB\-t, \-\-test\fR
Test compressed file integrity.
.TP
\fB\-h, \-\-help\fR
Show usage information and exit.
.TP
\fB\-v, \-\-verbose\fR
Verbose output.
.TP
\fB\-V, \-\-version\fR
Display version information and exit.
.SH PACKAGE CREATION OPTIONS
.TP
\fB\-a, \-\-all\fR
Create a pacoball for each package logged in the paco database.
.TP
\fB\-d, \-\-directory\fR=\fIDIR\fR
Create the pacoballs in directory DIR (default is '.').
.TP
\fB\-b, \-\-bzip2\fR
Compress with bzip2 (this is the default).
.TP
\fB\-g, \-\-gzip\fR
Compress with gzip.
.TP
\fB\-#\fR
Set the compression level (speed/quality balance). '#' is a number between 1
(faster compression) and 9 (best compression).
.TP
\fB\-\-fast\fR
An alias for -1.
.TP
\fB\-\-best\fR
An alias for -9.
.TP
\fB\-f, \-\-force\fR
Force overwrite of existing output files.
.SH PACKAGE EXTRACTION OPTIONS
.TP
\fB\-e, \-\-extract\fR
Extract (install) the given <pacoballs>, in directory '/' by default.
.TP
\fB\-l, \-\-log\fR
Log the file extraction with paco(8), retrieving the appropiate
package name from the name of the pacoball.
.TP
\fB\-C, \-\-root\fR=\fIDIR\fR
Extract the files into directory DIR (as the -C option in tar).
.SH FILES
.PP
\fI/etc/pacorc\fR - paco configuration file
.br
\fI/var/log/paco\fR - default paco log directory
.SH WEB SITE
The latest version of pacoball should be always available at:
.br
	http://paco.sourceforge.net
.SH COPYRIGHT
Copyright (C) 2004-2009 David Rosal <davidrr@sourceforge.net>
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH SEE ALSO
paco(8), pacorc(5), superpaco(8), rpm2paco(8)