mirror of
https://github.com/Zygo/bees.git
synced 2025-05-17 21:35:45 +02:00
bcf3e7de3e
The weird things distros do to the path where uuid.h gets installed have broken bees builds for the last time. We were only using uuid to support a legacy feature that was removed over four years ago. Hypothetical users who are upgrading directly from bees v0.1 should probably restart all the crawlers anyway--there were bugs. Also, if any such users exist, I respect their tremendous patience with the horrible performance all these years--bees got about 30x faster since v0.1. Signed-off-by: Zygo Blaxell <bees@furryterror.org>
91 lines
2.3 KiB
Markdown
91 lines
2.3 KiB
Markdown
Building bees
|
|
=============
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
* C++11 compiler (tested with GCC 4.9, 6.3.0, 8.1.0)
|
|
|
|
Sorry. I really like closures and shared_ptr, so support
|
|
for earlier compiler versions is unlikely.
|
|
|
|
Note that the C++ standard--and GCC's implementation of it--is evolving.
|
|
There may be problems when building with newer compiler versions.
|
|
Build failure reports welcome!
|
|
|
|
* btrfs-progs
|
|
|
|
Needed at runtime by the service wrapper script.
|
|
|
|
* [Linux kernel version](btrfs-kernel.md) gets its own page.
|
|
|
|
* markdown for documentation
|
|
|
|
* util-linux version that provides `blkid` command for the helper
|
|
script `scripts/beesd` to work
|
|
|
|
Installation
|
|
============
|
|
|
|
bees can be installed by following one these instructions:
|
|
|
|
Arch package
|
|
------------
|
|
|
|
bees is available in Arch Linux AUR. Install with:
|
|
|
|
`$ pacaur -S bees-git`
|
|
|
|
Gentoo package
|
|
--------------
|
|
|
|
bees is officially available in Gentoo Portage. Just emerge a stable
|
|
version:
|
|
|
|
`$ emerge --ask bees`
|
|
|
|
or build a live version from git master:
|
|
|
|
`$ emerge --ask =bees-9999`
|
|
|
|
You can opt-out of building the support tools with
|
|
|
|
`USE="-tools" emerge ...`
|
|
|
|
If you want to start hacking on bees and contribute changes, just emerge
|
|
the live version which automatically pulls in all required development
|
|
packages.
|
|
|
|
Build from source
|
|
-----------------
|
|
|
|
Build with `make`. The build produces `bin/bees` which must be copied
|
|
to somewhere in `$PATH` on the target system respectively.
|
|
|
|
It will also generate `scripts/beesd@.service` for systemd users. This
|
|
service makes use of a helper script `scripts/beesd` to boot the service.
|
|
Both of the latter use the filesystem UUID to mount the root subvolume
|
|
within a temporary runtime directory.
|
|
|
|
### Ubuntu 16.04 - 17.04:
|
|
`$ apt -y install build-essential btrfs-tools markdown && make`
|
|
|
|
### Ubuntu 18.10:
|
|
`$ apt -y install build-essential btrfs-progs markdown && make`
|
|
|
|
### Ubuntu 14.04:
|
|
You can try to carry on the work done here: <https://gist.github.com/dagelf/99ee07f5638b346adb8c058ab3d57492>
|
|
|
|
Packaging
|
|
---------
|
|
|
|
See 'Dependencies' below. Package maintainers can pick ideas for building and
|
|
configuring the source package from the Gentoo ebuild:
|
|
|
|
<https://github.com/gentoo/gentoo/tree/master/sys-fs/bees>
|
|
|
|
You can configure some build options by creating a file `localconf` and
|
|
adjust settings for your distribution environment there.
|
|
|
|
Please also review the Makefile for additional hints.
|