◀ All Man Pages

TUX

Section 8

package manager for OpenTUX

Synopsis

tux [ -r root ] [ -N ] [ -v ]

command

[ args ]

Description

tux is the high-level package manager for OpenTUX. It resolves dependencies, drives mkpkg(8) for building, and calls pkg.add(8) / pkg.del(8) for installation and removal. Port directories are searched in the order defined in tux.conf(5). When multiple ports provide the same package, the last matching directory wins.

Commands

Package Operations

install pkg: Install a package and its dependencies. Builds from source if no binary archive exists.
update pkg: Update a package to the version in the ports tree. Resolves and updates dependencies as needed.
remove pkg: Remove an installed package.
prepare [pkg]: Install build dependencies (makedeps) for a port. If no package is given, operates on the current directory.
build [pkg]: Build a package without installing it. If no package is given, operates on the current directory.

System Operations

sysup: Update all outdated packages. Compares installed versions against the ports tree and upgrades each outdated package in dependency order.
autoremove: Remove orphaned packages — packages that were installed as dependencies but are no longer required by any installed package.
diff: Show version differences between installed packages and the ports tree.

Query Operations

depends pkg: Show the dependency tree for a package.
rdepends pkg: Show reverse dependencies — packages that depend on pkg .
orphans: List packages that are not required by any other installed package.

Database Operations

initdb: Populate the dependency database from installed packages. Scans all installed packages, finds their ports, and records their dependencies. Run once after initial installation or when the database is corrupted.
checkdb: Verify the dependency database for consistency. Reports packages with missing or broken dependencies.

Lock Operations

lock pkg: Lock a package to prevent sysup from updating it.
unlock pkg: Unlock a previously locked package.
locked: List all locked packages.

Options

-r path, --root path: Alternative installation root. Passed through to mkpkg, pkg.add, and pkg.del.
-N, --no-deps: Operate on the specified package only, without resolving or installing dependencies.
-v, --verbose: Verbose output.

Files

__IBLOCK__/etc/tux.conf: Package manager configuration. See tux.conf(5).
__IBLOCK__/var/lib/tux/deps.db: Dependency database.
__IBLOCK__/var/lib/tux/locked: List of locked packages.
__IBLOCK__/var/lib/pkg/db: Package database (shared with pkgtools).

Exit Status

0 on success, 1 on error.

Examples

tux install firefox          # install with dependencies
tux update openssl           # update single package
tux sysup                    # update entire system
tux prepare                  # install makedeps for cwd port
tux diff                     # see what's outdated
tux depends mesa             # show mesa's dep tree
tux rdepends openssl         # who depends on openssl
tux lock rust               # prevent kernel updates
tux autoremove               # clean up orphans

TUX