pkg-get/doc/pkg-get.8

233 lines
5.0 KiB
Groff

.TH pkg-get 8 "July 13, 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 [\fB--all\fP]
Show a list of outdated packages.
The \fB--all\fP option also displays locked packages.
.TP
.B
quickdiff
Show a compact list of outdated packages.
.TP
.B
sysup [\fB--all\fP]
Update all outdated packages, download if necessary.
Locked packages are excluded from the operation
unless \fB--all\fP is passed.
.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
quickdep <package>
Show a brief list of dependencies for package.
.TP
.B
dependent <package> [\fB--all\fP]
Show installed (or all with the \fB--all\fP option) packages
that depend from package.
.TP
.B
path <package>
Show local path of package.
.TP
.B
info <package>
Show information about package.
.TP
.B
current <package>
Show currently installed version of package.
.TP
.B
isinst <package>
Display whether a package is installed.
.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
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 \fBprt\-get\fP(8).
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 -> "None". 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
codes 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
help
Display brief help screen.
.TP
.B
version
Show \fBpkg-get\fP version.
.SH OPTIONS
.TP
.B
\fB-r\fP <root>
Use <root> directory for operations involving the package database
(install, depinst, update, isinst, current, listinst, diff, quickdiff, sysup).
This option does not affect the directories from which \fBpkg-get\fP loads the
metadata or tarballs; those settings are still governed by the entries in
the configuration file.
.TP
.B
\fB-do\fP
Download only. Applicable to: sysup, install, depinst, 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
Execute pre-install script if available.
.TP
.B
\fB--post-install\fP
Execute post-install script if available.
.TP
.B
\fB--install-scripts\fP
Execute 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 qt6-base \fB-f\fP
Install qt6-base 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>, John McQuah <jmcquah@disroot.org>
.SH SEE ALSO
\fBpkgadd\fP(8), \fBprt-get\fP(8), \fBpkg-repgen\fP(8)