Manages a local copy of the HardenedBSD source tree
Find a file
0x1eef f8bcf60ae1
Some checks are pending
sourcezap / shellcheck (push) Waiting to run
Add setup/setup-user
2024-07-26 11:32:27 -03:00
.github/workflows Update .github/ 2024-05-11 20:29:04 -03:00
bin Add setup/setup-user 2024-07-26 11:32:27 -03:00
libexec/sourcezap Add setup/setup-user 2024-07-26 11:32:27 -03:00
man/man8 Fix typo in man page 2024-06-22 20:21:54 -03:00
share/sourcezap Add setup/setup-user 2024-07-26 11:32:27 -03:00
.projectile First commit 2024-05-11 16:03:00 -03:00
Makefile Fix Makefile 2024-07-20 01:43:11 -03:00
README.md Add setup/setup-user 2024-07-26 11:32:27 -03:00

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

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

Sources

License

BSD Zero Clause
See LICENSE