This package requires:
- Go 1.1+ with CGO enabled
- Mono (macOS or Linux) or Visual Studio (Windows) (build-time only)
- FoundationDB C API 2.0.x-6.1.x (part of the FoundationDB client packages)
Use of this package requires the selection of a FoundationDB API version at runtime. This package currently supports FoundationDB API versions 200-610.
To install this package, you can run the "fdb-go-install.sh" script (for versions 5.0.x and greater):
./fdb-go-install.sh install --fdbver <x.y.z>
The "install" command of this script does not depend on the presence of the repo in general and will download the repository into your local go path. Running "localinstall" instead of "install" will use the local copy here (with a symlink) instead of downloading from the remote repository.
You can also build this package, in the top level of this repository run:
This will create binary packages for the appropriate platform within the "build" subdirectory of this folder.
If you used the bindings with modules before the addition of the
go.mod file in the foundation repo,
it may be necessary to update the import path in your
By default, a module enabled
go get will add something like this to your
You will need to delete that line, then run
go get github.com/apple/foundationdb/bindings/go@version.
You should now have a line like this in your
@version is only necessary if you previously locked to a
specific version or commit, in which case you'd replace
version with a commit hash or tag.