About

sourcezap manages a local copy of the HardenedBSD source tree. The copy of the source tree is maintained by members of the _sourcezap group, and a copy of the source tree can be installed into /usr/src/ by root.

Examples

CLI: setup-sourcezap

setup-sourcezap should be run after installing sourcezap for the first time.
There is no harm in running setup-sourcezap multiple times:

# Add the '_sourcezap' user, group and home directory
# This command requires root privileges
root@localhost# setup-sourcezap

CLI: sourcezap

# Clone the HardenedBSD source tree into /home/_sourcezap/src/
# This command is delegated to the '_sourcezap' user
user@localhost$ sourcezap clone

# Pull updates into /home/_sourcezap/src/
# This command is delegated to the '_sourcezap' user
user@localhost$ sourcezap pull

# Checkout a branch other than the default: hardened/14-stable/master
# This command is delegated to the '_sourcezap' user
user@localhost$ sourcezap checkout hardened/13-stable/master

# Install /home/_sourcezap/src/ into /usr/src/
# This command requires root privileges
root@localhost# sourcezap install

# Remove the contents of /usr/src/ and /home/_sourcezap/src/
# This command requires root privileges
root@localhost# sourcezap rm

Environment

• $SOURCEZAP_CLONEURL
  The URL of a git repository
  Default: https://git.HardenedBSD.org/HardenedBSD/HardenedBSD.git

• $SOURCEZAP_INSTALLDIR
  The directory where the source tree will be installed
  Default: /usr/src/

Install

Package

sourcezap is available from the HardenedBSD ports tree.
pkg install sourcezap should work too but expect slower updates.

Git

The most recent version of sourcezap can be installed via git:

# Clone
user@localhost$ git clone https://git.hardenedbsd.org/0x1eef/sourcezap.git
user@localhost$ cd sourcezap

# Install
root@localhost# make install
root@localhost# setup-sourcezap

# Add user to '_sourcezap' group
root@localhost# pw groupmod -n _sourcezap -m <user>

Requirements

• doas
• git

Sources

• GitHub
• GitLab
• git.HardenedBSD.org/@0x1eef
• brew.bsd.cafe/@0x1eef

License

BSD Zero Clause
See LICENSE