Man1 - pactrans.1

Table of Contents



NAME

pactrans, pacinstall, pacremove - install/remove alpm packages

SYNOPSIS

pactrans [options] <target>… pacinstall [options] <target>… pacremove [options] <target>… pactrans (–help|–version)

DESCRIPTION

Install/remove alpm packages. The pacinstall and pacremove aliases are provided as a convenience, differing only in their default interpretation of targets. Otherwise, they are identical.

If stdin is not connected to a terminal, pkgspec/s to install/remove will be read from /stdin.

OPTIONS

Operations

Operation options affect the interpretation of all targets following them until another operation option is encountered.

–spec (pactrans default)
Interpret following targets as pkgspec/s. If a /pkgspec indicates a package file or a repository package, it will be installed. If it indicates a package in the local database, it will be removed. See PKGSPEC for details on the format.
–install (pacinstall default)
Interpret following targets as packages to be installed from a repository. If only the package name is provided repositories will be searched in the order they are declared.
–remove (pacremove default)
Interpret following targets as package names to be uninstalled.
–file
Interpret following targets as paths to package files to be installed.
–sysupgrade
Upgrade installed packages.

Configuration Options

–cache-dir=path
Set an alternate cache directory path.
–config=path
Set an alternate configuration file path.
–dbext=extension
Set an alternate sync database extension.
–dbpath=path
Set an alternate database path.
–logfile=path
Set an alternate log file path.
–root=path
Set an alternate installation root.
–sysroot=path
Set an alternate system root. See pacutils-sysroot (7).
–null[=sep]
Set an alternate separator for values parsed from stdin. By default a newline \n is used as the separator. If –null is used without specifying sep NUL will be used.
–debug
Display additional debugging information.
–print-only
Display the what the transaction would do and exit.
–no-confirm
Assume default responses to all prompts.
–no-timeout
Disable low-speed timeouts for downloads.
–help
Display usage information and exit.
–version
Display version information and exit.

Transaction Options

–dbsync
Update sync databases before performing the transaction.
–dbonly
Make the changes to the database without actually extracting or removing any packages.
–nodeps
Ignore dependency versions. Pass twice to ignore dependency checks altogether.
–no-scriptlet
Do not run package install scripts.
–no-hooks
Do not run transaction hooks.

Sysupgrade Options

–ignore-pkg=package
Ignore upgrades for package package. package may be a shell-style glob pattern.
–ignore-group=group
Ignore upgrades for any packages in group group. group may be a shell-style glob pattern.

–install*/–file* Options

–as-deps
Mark all installed packages as dependencies.
–as-explicit
Mark all installed packages as explicitly installed.
–download-only
Download packages without actually installing them.

–remove Options

–cascade
Uninstall all installed packages that depend on a package being uninstalled.
–no-backup
Do not save .pacsave backups.
–recursive
Uninstall any dependencies of packages being removed that are not required by any other packages.
–unneeded
Do not uninstall any packages required by an installed package.

Prompt Disposition Options

–resolve-conflicts=method
Select a method to use for resolving conflicts. Possible values for method are:
“prompt”
Prompt the user to remove the installed conflicting package.
“none”
Do not remove any conflicting packages.
“all”
Remove any conflicting packages.
“provided”
Remove a conflicting package if the new package provides it.
“depends”
Remove a conflicting package if it was installed as a dependency.
“provided-depends”
Remove a conflicting package if it was installed as a dependency and the new package provides it.
–resolve-replacements=method
Select a method to use for resolving replacements. Possible values for method are:
“prompt”
Prompt the user to replace the package.
“none”
Do not replace any packages.
“all”
Perform all available package replacements.
“provided”
Perform replacements where the new package provides the old one.
“depends”
Perform replacements where the old package was installed as a dependency.
“provided-depends”
Perform replacements where the old package was installed as a dependency and the new package provides the old one.
–install-ignored-packages=prompt|yes|no
Set the disposition for prompts to install ignored packages.
–delete-corrupt-files=prompt|yes|no
Set the disposition for prompts to delete corrupt package.
–use-first-provider=prompt|yes|no
Set the disposition for prompts to select a provider. If set to yes, the first available provider will be selected.
–skip-unresolvable=prompt|yes|no
Set the disposition for prompts to skip packages with unresolvable dependencies.
–import-pgp-keys=prompt|yes|no
Set the disposition for prompts to import missing PGP keys.
–yolo
Set all prompt disposition options to their all or yes value and set –no-confirm.

NOTE: regardless of the disposition options chosen, all dependencies must still be satisfied in order for the transaction to succeed unless –nodeps is used as well.

PKGSPEC

A pkgspec is a string that can identify an individual package. Accepted formats are:

<repository>/<package>
core/pacman local/pacman
<proto>://<path/to/package/file>
file:///var/cache/pacman/pkg/pacman-4.1.0-1-x86_64.pkg.tar.xz

EXAMPLES

Replace foo with bar
pactrans local/foo baz/bar Or, if bar’s repository is unknown: pacinstall bar –remove foo
Install foo and bar:
pactrans –install foo bar

CAVEATS

pactrans determines whether or not to read pkgspec/s from /stdin based on a naive check using isatty (3). If pactrans is called in an environment, such as a shell function or script being used in a pipe, where stdin is not connected to a terminal but does not contain pkgspec/s to install/remove, pactrans should be called with /stdin closed. For POSIX-compatible shells, this can be done with <&-.

Author: dt

Created: 2022-02-22 Tue 16:17