2.8 KiB
About
sourcezap is a utility that manages a local copy of the
HardenedBSD source tree.
The copy of the source tree is maintained by members of
the _sourcezap group, and the copy of the source tree
can be installed into /usr/src/ by root.
CLI
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: group
The following commands are delegated to the _sourcezap user and
restricted to members of the _sourcezap group. The restrictions
are enforced by sourcezap and to a lesser extent by
doas(1):
-
sourcezap clone
Clone the HardenedBSD source tree into/home/_sourcezap/src/ -
sourcezap pull
Pull updates into/home/_sourcezap/src/ -
sourcezap checkout
Checkout a branch other than the default:hardened/14-stable/master -
sourcezap sh
Run/bin/shwithin/home/_sourcezap/src/
CLI: superuser
The following commands are restricted to root.
The restrictions are enforced by sourcezap:
-
sourcezap rm
Remove the contents of/usr/src/and/home/_sourcezap/src/ -
sourcezap install
Install/home/_sourcezap/src/into/usr/src/
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
sourcezap is available
from the HardenedBSD ports tree.
pkg install sourcezap should work too but expect slower updates. 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>