Skip to content

Commit

Permalink
document the FreeBSD changes
Browse files Browse the repository at this point in the history
  • Loading branch information
Lionel Fourquaux committed Jun 18, 2020
1 parent bfe6c4b commit 550ba49
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 1 deletion.
3 changes: 2 additions & 1 deletion AUTHORS
Original file line number Diff line number Diff line change
@@ -1,13 +1,14 @@
Contributors

(Including those who have played a significnat role in design and test,
(Including those who have played a significant role in design and test,
and those who authored open source code that was pulled in here.)

Hafeez Bana
Brian Behlendorf
Trent D'Hooge
Chris Dunlap
Sheila Faulkner
Lionel Fourquaux
Jim Garlick
Maya Gokhale
Mark Grondona
Expand Down
30 changes: 30 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,19 @@ make
make check
```

#### On FreeBSD

```
portmaster security/munge
portmaster lang/lua53
./autogen.sh
./configure
make
```

See also the remarks below if you want a server that supports impersonation
(access=user in v9fs).

### Kernel Client

The kernel 9P client, sometimes referred to as "v9fs", consists
Expand Down Expand Up @@ -92,6 +105,23 @@ Note that at this point diod is only being tested with NFS file systems.
Use it with Lustre or GPFS at your own peril - but if you do, please
report issues!

### Impersonation on FreeBSD

FreeBSD does not support per-thread credentials. If you want a diod server
that supports v9fs' access=user, you can:
* build diod with `--enable-impersonation` (disabled by default on FreeBSD)
* install `net/nfs-ganesha-kmod` from ports (or at least the modules
`setthreadgid`, `setthreadgroups` and `setthreaduid`) or from
[source](https://github.com/nfs-ganesha/nfs-ganesha)
* before stating diod, load the modules providing additional syscalls:
```
kldload /path/to/nfs-ganesha-kmod/setthreaduid/setthreaduid.ko
kldload /path/to/nfs-ganesha-kmod/setthreadgid/setthreadgid.ko
kldload /path/to/nfs-ganesha-kmod/setthreadgroups/setthreadgroups.ko
```

Please read nfs-ganesha-kmod's README first, and use at your own risk.

# Support

Use GitHub!
Expand Down

0 comments on commit 550ba49

Please sign in to comment.