NAME
kiss —
package manager
SYNOPSIS
kiss |
[a|b|c|d|H|i|l|p|r|s|u|U|v] [pkg...] |
DESCRIPTION
kiss is a tiny, self-contained package
manager written in POSIX-compliant shell script. It is written with
portability in mind.
Running kiss without any arguments prints
help output. Every action can be written as the full name or aliased by the
first letter:
- a|alternatives
- List and swap package alternatives
- b|build
- Build packages
- c|checksum
- Generate checksums
- d|download
- Download sources
- H|help-ext
- List all installed extensions (see Extensions).
- i|install
- Install packages
- l|list
- List installed packages
- p|preferred
- List the owners of all files with alternatives
- r|remove
- Remove packages
- s|search
- Search for packages
- u|update
- Update the repositories
- U|upgrade
- Update the system
- v|version
- Print package manager version
Extensions
Anything in the user's $PATH which matches
the glob ‘kiss-*’ will be directly
usable via the package manager. The shortest available alias may also be
used for each extension. The second line in the script acts as a one-line
doc string. The default extensions are:
- chroot
- Enter a kiss chroot
- depends
- Display a package's dependencies
- fork
- Copy a package's repository files into the current directory
- help
- Read KISS documentation
- link
- Link a repository file to another repository
- maintainer
- Find the maintainer of a package
- manifest
- Display all files owned by a package
- new
- Create a boilerplate package
- orphans
- List orphaned packages
- outdated
- Check repository for outdated packages
- owns
- Check which package owns a file
- revdepends
- Display packages which depend on package
- size
- Show the size on disk for a package
ENVIRONMENT
KISS_CHK- The utility to use for SHA256 checksums.
Valid: openssl, sha256, sha256sum, shasum, digest. Default is the first available in that order.
KISS_CHOICE- Set to ‘
0’ to disable the alternatives system and error on any detected file conflicts. KISS_COLOR- Set to ‘
0’ to disable colorful output; otherwise colors are disabled when the utput is not a terminal. KISS_COMPRESS- Compression method to use for built package tarballs.
Valid: gz (default), bz2, lzma, lz, xz, zst.
KISS_DEBUG- Set to ‘
1’ to avoid deleting temporary directories after building packages, for debugging. KISS_ELF- Which readelf command to use.
Valid: readelf (default), *-readelf, ldd.
KISS_FORCE- Set to ‘
1’ to bypass dependency checks and force building/installation/removal of packages. KISS_GET- Which utility to use when downloading sources.
Valid: aria2c, axel, curl, wget, wget2. Default is the first available in that order.
KISS_HOOK- A colon-separated list of absolute paths to executable files which are run as hooks.
KISS_KEEPLOG- Set to ‘
1’ to keep build logs for successful builds as well as failing ones. KISS_PATH- A colon-separated list of paths to repositories, directories which contain packages. Repositories earlier in the list have a higher priority in the case of a package being found in multiple repos.
KISS_PID- Used to determine the exact name of temporary directories, can be specified for debugging.
KISS_PROMPT- Set to ‘
0’ to say “yes” and skip all prompts from the package manager. KISS_ROOT- Where installed packages will go. Can be used to install packages to somewhere other than /.
KISS_STRIP- Set to ‘
0’ to disable stripping package binaries and libraries globally. KISS_SU- Privilege escalation utility to use.
Valid: ssu, sudo, doas, su, or any other tool compatible with sudo-like arguments.
KISS_TMPDIR- Temporary directory used for builds. Can be set to a tmpfs (often /tmp for example) so that builds happen in memory and are faster.
FILES
kiss does not use any configuration files.
Files used in packages are documented in
kiss(5).
EXIT STATUS
The kiss utility exits 0 on
success, and >0 if an error occurs.
SEE ALSO
AUTHORS
kiss was created by Dylan
Araps and the community.