Fpkg is a small program to interact with FreeBSD packages. While the official
pkg program works perfectly well for
package management, it is not as practical to build packages. Among other
things:
- It forces the user to manually build the file and directory list and their checksum and permissions.
- It requires writing a shell script to create a user and/or group.
- It detects the ABI by analyzing ELF files in the local system, a method that fails on Alpine Linux (freebsd/pkg#2065).
- It is not packaged out of FreeBSD, making it annoying to cross-build FreeBSD packages. Building it manually requires multiple dependencies.
Fpkg is available for Linux/amd64 as a single binary file. You can download
it directly
from the latest GitHub release. You also build it yourself by running make build. Fpkg should run on all platforms supported by the Go compiler.
Fpkg uses a simple YAML configuration file describing the package to build.
Example:
name: "example"
version: "1.0.0"
short_description: "example package"
website_uri: "https://github.com/exograd/example"
maintainer: "Nicolas Martyanoff <[email protected]>"
file_owner: "root"
file_group: "wheel"
files:
- path: "/var/lib/example"
mode: "600"
- path_regexp: "/var/www/example/.*"
owner: "www"
group: "www"
directories:
- path: "/var/www/example"
owner: "www"
group: "www"You can then run fpkg:
fpkg build -c example.yaml example/
Where example/ is the directory containing the set of files to include in
the package.
Fpkg automatically builds the file and directory index, including the checksum, permissions, and the owner and group set in the manifest.
The path of the resulting .pkg file is printed on stdout; this way a
script running fpkg can easily find and copy the package archive to a remote
repository.