Manages a local copy of the HardenedBSD source tree
0x1eef
d4a18461ca
Some checks are pending
sourcezap / shellcheck (push) Waiting to run
In this context, we want to use ${*} rather than ${@} |
||
---|---|---|
.github/workflows | ||
bin | ||
libexec/sourcezap | ||
man/man8 | ||
share/sourcezap | ||
.projectile | ||
LICENSE | ||
Makefile | ||
README.md |
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
This command should be run after installing sourcezap for the first time:
# 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>