.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 [\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 [..] Install given packages, download if necessary. .TP .B update [..] 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 [..] Install given packages and relative dependencies. .TP .B depends Show a recursive list of dependencies for and their installation status. .TP .B quickdep Show a brief list of dependencies for . .TP .B dependent [\fB\-\-all\fP] Show installed (or all with the \fB\-\-all\fP option) packages that depend on . .TP .B path Show local path of . .TP .B info Show information about . .TP .B current Show currently installed version of package. .TP .B isinst Display whether a package is installed. .TP .B readme Print README information (if available) for the package. .TP .B list List all packages in the active repositories. .TP .B listinst List all installed packages. .TP .B dsearch Search for packages whose name or description contains . .TP .B search Search for packages whose name contains . .TP .B dup List all duplicate ports (present in more than one repository). .TP .B printf [\fB\-\-filter\fP=] 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 -> "None". 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 [..] Lock a package (exclude it from being updated in a \fBsysup\fP). .TP .B unlock [..] 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 OPTIONSB .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\-r\fP Use 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. When using \fB\-r\fP , the relevant pkgadd.conf is the one on the target filesystem, not the one where \fBpkg\-get\fP is running. Any custom directives in your pkgadd.conf should be copied to the corresponding location under the new root, or else you should pass the \fB\-\-aargs\fP option to tell \fBpkgadd\fP to read its configuration from a non-standard location. When combined with \fB\-\-pre\-install\fP or \fB\-\-post\-install\fP or \fB\-\-install\-scripts\fP, setting a root directory other than '/' has the side effect of copying the PKGINST shell script into the corresponding location under the new root. This action (and the subsequent chroot command) is the most direct way to accommodate the user's intention. Unfortunately it clutters the mounted volume with a small fragment of shell script. If such clutter is not desired, the option \fB\-r\fP should always be paired with the configuration setting 'runscripts no', leaving it up to the administrator of the mounted volume to perform any pre- or post-install tasks separately. .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 , John McQuah .SH SEE ALSO \fBpkgadd\fP(8), \fBprt\-get\fP(8), \fBpkg\-repgen\fP(8)