# spm

Simple Package Manager — a POSIX-compatible package manager for Linux.

`spm` builds, installs, upgrades, and removes `.spm` packages. A package is a compressed tar archive with a filename that encodes its identity: `<name>#<version>-<release>.spm`.

## Install

```sh
make install                          # install to /usr/bin/spm
make install DESTDIR=/tmp/staging     # install to a staging directory
make install PREFIX=/usr/local        # install to /usr/local/bin/spm
make uninstall                        # remove spm and its man page
```

## Usage

```
spm -a              list all installed packages
spm -b <path>       build a package from the current directory
spm -h              print help
spm -i <file>       install a package (requires root)
spm -l <name>       list files installed by a package
spm -o <file>       find which package owns a file
spm -r <name>       remove an installed package (requires root)
spm -u <file>       upgrade or reinstall a package (requires root)
```

## Package format

`.spm` packages are compressed tar archives whose contents mirror the target filesystem tree. Files under `etc/` are automatically given a `.new` suffix during build so they don't overwrite existing configs on install — the `.new` file is moved into place only if the destination is absent or identical.

## Environment variables

| Variable | Description |
|---|---|
| `SPM_ROOT` | Alternate installation root (default: `/`) |
| `SPM_FORCEINSTALL` | Skip conflict detection |
| `SPM_VERBOSE` | Print each file as it's installed or removed |
| `SPM_COMPRESSION` | Compression for builds: `gzip` (default), `bzip2`, or `xz` |

## Database

Package metadata lives under `/var/lib/spm/` (or `$SPM_ROOT/var/lib/spm/`):

| Path | Contents |
|---|---|
| `db/<name>` | One file per package: version line + list of installed paths |
| `perms/<name>` | Non-standard directory permissions for the package |
| `owner/<name>` | Non-root directory ownership for the package |

## Examples

```sh
# Build
cd staged-files && spm -b /tmp/mypkg#1.0-1.spm

# Install / upgrade / remove
spm -i /tmp/mypkg#1.0-1.spm
spm -u /tmp/mypkg#1.1-1.spm
spm -r mypkg

# Query
spm -a              # what's installed?
spm -l mypkg        # what files did mypkg install?
spm -o /usr/bin/x   # what package owns /usr/bin/x?

# Alternate root (chroot / container)
SPM_ROOT=/mnt/rootfs spm -i /tmp/mypkg#1.0-1.spm

# Different compression
SPM_COMPRESSION=xz spm -b /tmp/mypkg#1.0-1.spm
```