Merge pull request #3880 from kpcyrd/docs/openbsd

Fix install_unsupported for openbsd, add docs

Author: whyrusleeping

README.md

@@ -132,6 +132,7 @@ mismatched APIs.
 #### Troubleshooting
 
 * Separate [instructions are available for building on Windows](docs/windows.md).
+* Also, [instructions for OpenBSD](docs/openbsd.md).
 * `git` is required in order for `go get` to fetch all dependencies.
 * Package managers often contain out-of-date `golang` packages.
   Ensure that `go version` reports at least 1.7. See above for how to install go.

Rules.mk

@@ -105,12 +105,14 @@ install: cmd/ipfs-install
 install_unsupported:
 	@echo "note: this command has yet to be tested to build in the system you are using"
 	@echo "installing gx"
-	go get -u github.com/whyrusleeping/gx
-	go get -u github.com/whyrusleeping/gx-go
+	go get -v -u github.com/whyrusleeping/gx
+	go get -v -u github.com/whyrusleeping/gx-go
+	@echo check gx and gx-go
+	gx -v && gx-go -v
 	@echo downloading dependencies
 	gx install --global
 	@echo "installing go-ipfs"
-	go install ./cmd/ipfs
+	go install -v -tags nofuse ./cmd/ipfs
 .PHONY: install_unsupported
 
 uninstall:

docs/openbsd.md

@@ -0,0 +1,36 @@
+# Building on OpenBSD
+
+## Prepare your system
+
+Make sure you have `git`, `go` and `gmake` installed on your system.
+
+```
+$ doas pkg_add -v git go gmake
+```
+
+## Prepare go environment
+
+Make sure your gopath is set:
+
+```
+$ export GOPATH=~/go
+$ echo "$GOPATH"
+$ export PATH="$PATH:$GOPATH/bin"
+```
+
+## Build
+
+The `install_unsupported` target works nicely for openbsd. This will install `gx`, `gx-go` and run `go install -tags nofuse ./cmd/ipfs`.
+
+```
+$ go get -v -u -d github.com/ipfs/go-ipfs
+
+$ cd $GOPATH/src/github.com/ipfs/go-ipfs
+$ gmake install_unsupported
+```
+
+if everything went well, your ipfs binary should be ready at `$GOPATH/bin/ipfs`.
+
+```
+$ ipfs version
+```