Skip to content
/ fpkg Public

FreeBSD pkg utilities

License

Notifications You must be signed in to change notification settings

exograd/fpkg

Repository files navigation

fpkg

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.

Installation

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.

Package building

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 <nicolas@n16f.net>"
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.