From 8a651b0372caeca6bfea4428151b1772c007597e Mon Sep 17 00:00:00 2001 From: Antonio SJ Musumeci Date: Thu, 29 Oct 2015 15:24:34 -0400 Subject: [PATCH] add support section to readme and manpage --- README.md | 12 +++++++++++- man/mergerfs.1 | 13 ++++++++++++- 2 files changed, 23 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 4708d3d6..83c5dd51 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ % mergerfs(1) mergerfs user manual % Antonio SJ Musumeci -% 2015-10-11 +% 2015-10-29 # NAME @@ -321,3 +321,13 @@ Linux does not support [pthread_setugid_np](https://developer.apple.com/library/ Turns out the setreuid syscalls apply only to the thread. GLIBC hides this away using RT signals to inform all threads to change credentials. Taking after **Samba** mergerfs uses **syscall(SYS_setreuid,...)** to set the callers credentials for that thread only. Jumping back to **root** as necessary should escalated privileges be needed (for instance: to clone paths). For non-Linux systems mergerfs uses a read-write lock and changes credentials only when necessary. If multiple threads are to be user X then only the first one will need to change the processes credentials. So long as the other threads need to be user X they will take a readlock allow multiple threads to share the credentials. Once a request comes in to run as user Y that thread will attempt a write lock and change to Y's credentials when it can. If the ability to give writers priority is supported then that flag will be used so threads trying to change credentials don't starve. This isn't the best solution but should work reasonably well. As new platforms are supported if they offer per thread credentials those APIs will be adopted. + +# SUPPORT + +#### Issues with the software +* github.com: https://github.com/trapexit/mergerfs/issues +* email: trapexit@spawn.link + +#### Support development +* Gratipay: https://gratipay.com/~trapexit +* BitCoin: 12CdMhEPQVmjz3SSynkAEuD5q9JmhTDCZA diff --git a/man/mergerfs.1 b/man/mergerfs.1 index b8795f27..cc2c7506 100644 --- a/man/mergerfs.1 +++ b/man/mergerfs.1 @@ -1,5 +1,5 @@ .\"t -.TH "mergerfs" "1" "2015\-10\-11" "mergerfs user manual" "" +.TH "mergerfs" "1" "2015\-10\-29" "mergerfs user manual" "" .SH NAME .PP mergerfs \- another FUSE union filesystem @@ -755,5 +755,16 @@ be used so threads trying to change credentials don\[aq]t starve. This isn\[aq]t the best solution but should work reasonably well. As new platforms are supported if they offer per thread credentials those APIs will be adopted. +.SH SUPPORT +.SS Issues with the software +.IP \[bu] 2 +github.com: https://github.com/trapexit/mergerfs/issues +.IP \[bu] 2 +email: trapexit\@spawn.link +.SS Support development +.IP \[bu] 2 +Gratipay: https://gratipay.com/~trapexit +.IP \[bu] 2 +BitCoin: 12CdMhEPQVmjz3SSynkAEuD5q9JmhTDCZA .SH AUTHORS Antonio SJ Musumeci .