pkg-get/doc/pkg-get.8

235 lines
4.7 KiB
Groff

." Text automatically generated by txt2man-1.4.7
.TH pkg-get 8 "April 23, 2006" "" ""
.SH NAME
\fBpkg-get \fP- a package management tool for CRUX Linux
\fB
.SH SYNOPSIS
.nf
.fam C
\fBpkg-get\fP \fIcommand\fP <arguments> [\fIoptions\fP]
.fam T
.fi
.SH DESCRIPTION
\fBpkg-get\fP is a simple package management tool for CRUX Linux.
It tries to replicate some of the most useful features of the
port management tool \fBprt-get\fP(8) to be used with binary packages.
\fBpkg-get\fP requires a remote or local package repository that
can be generated by repository maintainers with the
\fBpkg-repgen\fP(8) script.
.SH COMMANDS
.TP
.B
install <package1> [<package2>..<packageN>]
Install given packages,
download if necessary.
.TP
.B
update <package1> [<package2>..<packageN>]
Update given packages,
download if necessary.
.TP
.B
diff
Show a list of outdated packages.
.TP
.B
quickdiff
Show a compact list of outdated packages.
.TP
.B
sysup
Update all outdated packages. Download if necessary.
.TP
.B
depinst <package1> [<package2>..<packageN>]
Install given packages
and relative dependencies.
.TP
.B
depends <package>
Show a recursive list of dependencies for package
and their installation status.
.TP
.B
dependent <package> [\fB--all\fP]
Show installed (or all with the \fB--all\fP option) packages
that depend from package.
.TP
.B
quickdep <package>
Show a brief list of dependencies for package.
.TP
.B
info <package>
Show information about package.
.TP
.B
current <package>
Show currently installed version of package.
.TP
.B
path <package>
Show local path of package.
.TP
.B
readme <package>
Print README information (if available) for the package.
.TP
.B
list
List all packages in the repository.
.TP
.B
listinst
List all installed packages.
.TP
.B
isinst <package>
Display whether a package is installed.
.TP
.B
dsearch <string>
Search for packages which name or description contain <string>.
.TP
.B
search <string>
Search for packages which name contains <string>.
.TP
.B
dup
List all duplicates ports (present in more than one repository).
.TP
.B
printf <format string1> [\fB--filter\fP=<filter>]
Description blatantly
stolen from prt-get man file. Print formatted port list. Format string can
contain variables, which are replaced like this:
.RS
.IP \(bu 3
%n -> name
.IP \(bu 3
%p -> path
.IP \(bu 3
%v -> version
.IP \(bu 3
%r -> release
.IP \(bu 3
%d -> description
.IP \(bu 3
%e -> dependencies
.IP \(bu 3
%u -> url
.IP \(bu 3
%R -> Readme ("yes"/"no")
.IP \(bu 3
%E -> pre-install script ("yes"/"no")
.IP \(bu 3
%O -> post-install script ("yes"/"no")
.IP \(bu 3
%M -> "Nobody". for compatibility with prt-get
.IP \(bu 3
%P -> "Nobody". for compatibility with prt-get
.IP \(bu 3
%l -> is locked ("yes"/"no")
.IP \(bu 3
%i -> "no" if not installed, "yes" if it's installed and up to
date and "diff" if it's installed and a new version is in the
repository.
.RE
.PP
Use "\\n" and "\\t" to format your output (no additional format
specified suported). The optional format string2 can contain the
same variables as format string1 and is used to sort the output.
You can specify a wildcard filter to filter by package name.
.TP
.B
lock <package1> [<package2>..<packageN>]
Lock a package (ignore updates).
.TP
.B
unlock <package1> [<package2>..<packageN>]
Unlock a package.
.TP
.B
listlocked
Display a list of locked packages.
.TP
.B
sync
Syncronize local packages with the ones from the remote repository.
If the repository is local, this \fIcommand\fP does nothing.
.TP
.B
sysup
Update all outdated packages.
.TP
.B
help
Display brief help screen.
.TP
.B
version
Show \fBpkg-get\fP version.
.SH OPTIONS
.TP
.B
\fB-r\fP <root>
Use <root> directory when wrapping pkgadd. Note that
this only works with update / install !
.TP
.B
\fB-do\fP
Download only. Applicable to: sysup, depinst, install, update.
.TP
.B
\fB-f\fP
Force installing / upgrading. This is passed to \fBpkgadd\fP(8).
.TP
.B
\fB-im\fP
Ignore md5sum mismatches.
.TP
.B
\fB--aargs\fP="arguments"
pass the specified arguments to \fBpkgadd\fP(8).
.TP
.B
\fB--config\fP=/path/to/file
Use the specified configuration file.
.TP
.B
\fB--pre-install\fP
executes pre-install script if available.
.TP
.B
\fB--post-install\fP
executes post-install script if available.
.TP
.B
\fB--install-scripts\fP
executes pre-install and post-install
scripts if available.
.RE
.PP
.SH CONFIGURATION
Configuration is handled by the /etc/pkg-get.conf file,
\fIoptions\fP are explained in the file itself.
.SH EXAMPLES
.TP
.B
\fBpkg-get\fP install sqlite pysqlite
Install sqlite and pysqlite.
.TP
.B
\fBpkg-get\fP depinst kdebase \fB-f\fP
Install kdebase and all its dependencies, forcing upgrade.
.TP
.B
\fBpkg-get\fP sysup \fB-do\fP
Download new releases of all the outdated packages.
.SH AUTHORS
Simone Rota <sip@varlock.com>
.SH SEE ALSO
\fBpkgadd\fP(8), \fBprt-get\fP(8)