blob: f8d5939eacf74f7e16943cb13ed0dc0785666df6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
# 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
```
|
