portzap/README.md
2023-03-25 05:48:27 -03:00

56 lines
1.6 KiB
Markdown

## About
portzap is a utility for staying up to date with the
HardenedBSD ports tree. It is designed to make it easy
for unprivileged users who are members of the `_portzap`
group to create and update a transient copy of the ports
tree, which can then be installed into the `/usr/ports/`
directory by root. Once the initial installation is done,
future updates are incremental, which means that
portzap will only add, remove or update ports that have
changed since the last update.
## Usage
* __portzap clone__ <br>
Clones the ports tree into `/home/_portzap/ports/`.
* __portzap pull__ <br>
Pulls updates into `/home/_portzap/ports/`.
* __portzap install__ <br>
Installs `/home/_portzap/ports/` into `/usr/ports/`. <br>
## Install
portzap can be installed through git, or via a port. <br>
The port makes installation, and deinstallation easier.
__Port__ <br>
See [0x1eef/ports/freebsd/hardenedbsd/portzap](https://git.hardenedbsd.org/0x1eef/ports/-/tree/main/freebsd/hardenedbsd/portzap).
__Git__ <br>
```
git clone https://git.hardenedbsd.org/0x1eef/portzap.git
cd portzap
cp -R bin /usr/local/
cp -R libexec /usr/local/
pw useradd -n _portzap \
-c "portzap utility user" \
-m \
-s /sbin/nologin
pw groupmod -n _portzap -m <user>
```
## Sources
* [Source code (git.hardenedbsd.org)](https://git.hardenedbsd.org/0x1eef/portzap)
* [Source code (GitHub)](https://github.com/0x1eef/portzap)
* [Source code (GitLab)](https://gitlab.com/0x1eef/portzap)
## License
[BSD Zero Clause](https://choosealicense.com/licenses/0bsd/). <br>
See [LICENSE](./LICENSE).