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
74
75
76
77
78
79
80
81
82
83
84
85
86
|
# apkg helper scripts
autils includes several helper scripts that work alongside `apkg` for package inspection, cleanup, and maintenance. See `man <program>` for full details on each command.
## apkg-chroot
Enter a chroot environment with virtual filesystems mounted. Useful for building packages or performing system maintenance inside an alternative root.
```sh
apkg-chroot /mnt/alice # launch interactive shell
apkg-chroot /mnt/alice apkg -i mypkg # run a command inside the chroot
```
Must be run as root. Mounts `/dev`, `/proc`, `/sys`, `/run`, copies `/etc/resolv.conf`, and cleans up all mounts on exit.
## apkg-clean
List stale `.spm` package files and orphaned source tarballs that are no longer referenced by any current package recipe. Pipe to `xargs rm` to actually clean up.
```sh
apkg-clean # list all unreferenced files
apkg-clean -p # list only stale packages
apkg-clean -s # list only stale sources
apkg-clean | xargs rm # remove them
```
## apkg-deps
Show runtime library dependencies of an installed package. Uses `ldd` to find shared libraries needed by the package's binaries, then maps those libraries back to the packages that provide them.
```sh
apkg-deps mypkg
```
Useful for discovering implicit runtime dependencies not listed in the formal `depends` file. Excludes the package itself and base system packages (gcc, musl, binutils, glibc).
## apkg-foreign
List installed packages that are not found in any configured repository. These may have been installed from an external source or had their recipes removed.
```sh
apkg-foreign
```
Takes no arguments; outputs one package name per line.
## apkg-genabuild
Scaffold a new package recipe from a source URL. Parses the name and version from the URL and creates a directory with skeleton `abuild` and `info` files.
```sh
apkg-genabuild https://example.com/mypkg-1.2.3.tar.gz
apkg-genabuild https://github.com/user/repo/archive/v1.0.tar.gz myname
```
Special handling for GitHub tag archives, PyPI packages (prefixes `python-`), and CPAN packages (prefixes `perl-`). An optional second argument overrides the derived package name.
## apkg-orphan
List orphan packages: packages that are installed and exist in a repository, but have no other installed package depending on them. These may be safe to remove.
```sh
apkg-orphan
```
Takes no arguments; outputs one package name per line.
## apkg-purge
Remove a package and all its dependencies that are no longer needed by any other installed package. This is a "deep" removal compared to `apkg -r` which only removes the specified package.
```sh
apkg-purge mypkg # dry-run: show what would be removed
apkg-purge -p mypkg # actually purge from the system
```
## apkg-redundantdeps
Find redundant entries in `depends` files. A dependency is redundant if another listed dependency already pulls it in transitively.
```sh
apkg-redundantdeps mypkg # check one package
apkg-redundantdeps # check all packages
apkg-redundantdeps -f mypkg # fix by removing redundant entries
apkg-redundantdeps -f # fix all packages
```
|
