AKABEI(8)

NAME
akabei - Chakra package manager: CLI frontend

SYNOPSIS

akabei <operation> [options] [targets]

DESCRIPTION

Akabei is the CLI frontend to the Akabei suite. It handles the most crucial operations of the package manager.

Any valid invocation of akabei must include an operation to specify the action to perform, zero or more options in any position, and if the operation requires them one or more targets the action is to be performed on. A target is usually a package name, a filename, a URL, or a search string: the specific format depends on the nature of the operation.

OPERATIONS

Operations are divided into the following categories.

Query
    Includes all the operations querying the local package database for information. This allows you to know which packages are installed on your system, plus some meta-information about them (e.g. installation size, version, dependencies or conflicting packages). By default all operations are run against the Akabei local database; using the -p option is possible to run them on individual package files (see Options below). Packages are represented as archives in the .tar.xz form.

Remove
    Operations removing packages from your system: all files owned by the targets are removed and the local database is updated accordingly.

Sync
    Synchronize the local database with the remote ones, upgrading all the out-dated local packages. This category includes the operation for installing a new package from the official repository and for querying the repository information.

Upgrade
    See Upgrade Operations below.

Perform
    See Perform Operations below.

QUERY OPERATIONS

local
    Shows a list of all the packages installed on the system. Without -q, a description will be also printed.

search -l <regexp>
    Searches the local database for packages whose name or description matches the given regexp. If multiple expressions are supplied, only those packages matching ALL the terms are returned.

info -l <package>
    Displays more extended information about an installed package. Note that the argument must be the complete name of the package.

group -l <group>
    Lists all the installed packages categorized into the group.

changelog <package>
    Prints the changelog of the package, if present.

deps
    Shows all the packages that were installed as dependencies for other packages.

explicit
    Shows all the packages that were installed after an explicit request (i.e. using the install operation).

owner <file>
    Returns the package that owns the file. The path can be relative or absolute.

check <package>
    Checks if all the files belonging to the package are present in the system.

new
    Returns all the upgradeable packages, i.e., packages for which a newer version was found in the remote repositories.

orphans
    Prints all the orphans, i.e., packages that were installed as dependencies but are not required by any package currently installed on the system. See Remove operations to know how to delete them all with one command.

REMOVE OPERATIONS

remove <package>
    Removes a package from the system.

clean
    Removes all the orphans, i.e., packages that were installed as dependencies but are not required by any package currently installed on the system. We suggest you clean your system periodically to avoid wasting disk space for packages not anymore useful to anybody.

SYNC OPERATIONS

install <package>
    Installs a new package from the repository, downloading all the belonging files and updating the local database. All dependencies are automatically found and installed if not already present in the local database; circular dependencies are detected here to make sure the system stays in a safe state. The same behavior applies to any conflicting package the user may have installed.

search <regexp>
    This is the counterpart to the operation seen in the Query operations section for querying the local database without the -l switch, it searches thorough all the databases for a package description/name matching the regular expression.

info <package>
    This is the counterpart to the operation seen in the Query operations section for getting detailed information about an installed package without the -l switch, it searches the package only in the remote databases and returns the first occurrence.

group <group>
    This is the counterpart to the operation seen in the Query operations section for printing the list of packages belonging to a group without the -l switch, all the packages belonging to the group are returned.

sync
    Akabei maintains a local copy of each remote database to speed up queries. With this operation, the local copies are synced with the correspondent remote versions, in order to obtain the latest changes.

update
    Updates all the packages for which a newer version is found in the remote databases. Note that to know which packages are to be updated, this operation refers to the local copies of the remote databases Akabei maintains it is advisable to refresh the copies before running this action (see the next operation).

upgrade
    This simply runs the two preceding operations one after the other, so it guarantees your system will be upgraded to the latest versions available. All the options applied to sync or update are valid also here.

newest <package>
    This synces the databases before installing a new package, ensuring you will get the latest version. All the options applied to sync or install are also valid here.

repo <repo URL>
    Lists all packages in a repository.

UPGRADE OPERATIONS

get <source>
    Upgrades or adds packages to the system, installing dependencies from synced repos if required. The source can be a file path or URL.

PERFORM OPERATIONS

perform <target list>
    This operation allows you to perform a series of installations and removals in one go. Each package name present in the target list must be ended with the suffix + to install it, or with the suffix - to remove it. All options that control the behavior of install and remove are valid here.

OTHER OPERATIONS

help
    Prints the help message, with a synthetic description of each command.

version
    Prints the current version.

authors
    Prints information about the authors.

license
    Prints the full text of the license Akabei is released under.

OPTIONS

-p, --file <package file>
    Instructs every action that normally would query the local database to query the supplied package file for information. This is useful to print in an organized fashion the information contained inside a package archive.

-l, --local
    This is a switch for the operations info, search and group to limit their search only to the local database.

-q, --quiet
    Prints less information in queries and searches.

--asdeps
    Forces all the requested packages to be installed as dependencies. Be warned that if they are not required by any other package in the system, they will be appear in the orphans list.

--asexplicit
    Forces all the packages considered in an install operation to be added to the local database as explicitly installed. Such packages will never appear in the orphans list.

-w, --nodeps
    During installation, either from repositories or separated file/URL, skips the dependency check. You won’t be warned of the presence of circular dependencies either.

-f, --force
    During installation or removals, forces the operation to complete even in the presence of file conflicts or minor errors.

-d, --downloadonly
    Only downloads any target specified without performing any operation.

--needed
    When reinstalling, skips all up-to-date packages.

--ignore <packages>
    In queries, searches or installations, skips all the packages in the list. They won’t be considered as dependencies (keep in mind the possible risks!) and will never appear in the result of a search.

--ignoregroup <groups>
    In the same way as above, ignores all the packages belonging to at least one of the specified groups.

-k, --dbonly
    Changes only database entries, leaving the files in place.

-n, --nosave
    When removing, also removes configuration files. Note that this isn’t the default behavior: configuration files are renamed with an .akabeisave extension.

-s, --recursive
    When removing, recursively removes all the dependencies of a package, navigating all the tree of the dependencies. This is a safe option: dependencies which were installed explicitly by the user, or are required by at least one package we’re not going to remove, are skipped and left installed. To disable these security checks and just remove any dependency, use the Force option.

--root <dir path>
    Changes the Akabei root directory to a different path.

--cachedir <dir path>
    Specifies a different path for the Akabei cache.

--dbpath <dir path>
    Specifies a different path where Akabei should look for the databases.

--config <config file>
    Sets a different configuration file for Akabei.

EXAMPLES

akabei perform ccr+ perl- kate+
    Installs ccr and kate (dependencies included) and removes perl.

akabei get /home/user/glibc-2.14.1-1-x86_64.pkg.tar.xz
    Installs glibc from a user file.

akabei search develop -ql --ignoregroup=desktop
    Searches only the local database for the keyword develop, printing less information and ignoring all packages belonging to the desktop group.

CONFIGURATION

See akabei.conf(5) for more details on configuring Akabei using the akabei.conf file.

BUGS

Report any bug in the official Chakra BugTracker, https://code.chakralinux.org in the Akabei section. Try to include as much detail as possible in your explanation.

SEE ALSO

pakabei(8), akabei.conf(5), akabei-clean-cache(8), akabei-config(8), akabei-key(8), akabei-db-import(8), akabei-conf-import(8)

AUTHOR

Lisa Vitolo <<shainer@chakralinux.org>>
    Author.