aboutsummaryrefslogtreecommitdiffstats
path: root/git-init-acl.1
diff options
context:
space:
mode:
authorWolfgang Müller2022-03-03 15:15:19 +0100
committerWolfgang Müller2022-03-03 15:15:19 +0100
commit92ba675e4bffaca19af1d354783c33b0d9dca069 (patch)
tree08e1d05dc899eb85829c555b4949ddaea79ac553 /git-init-acl.1
parent65e9587af04fcae23c9d0cf37f185b7555435256 (diff)
downloadgit-helpers-trunk.tar.gz
Rename git-init-shared(1) to git-init-acl(1)HEADtrunk
We have always felt that the name of this program was too close to the invocation of 'git init --shared' which does something similar. Make it clear in the name that we're working with POSIX ACLs instead of normal permission sets as 'git init --shared' does.
Diffstat (limited to 'git-init-acl.1')
-rw-r--r--git-init-acl.142
1 files changed, 42 insertions, 0 deletions
diff --git a/git-init-acl.1 b/git-init-acl.1
new file mode 100644
index 0000000..2bf8b12
--- /dev/null
+++ b/git-init-acl.1
@@ -0,0 +1,42 @@
+.Dd July 19, 2021
+.Dt GIT-INIT-ACL 1
+.Os
+.Sh NAME
+.Nm git-init-acl
+.Nd create and share a git repository amongst multiple users
+.Sh SYNOPSIS
+.Nm git init-acl
+.Ar directory
+.Op Ar user...
+.Sh DESCRIPTION
+.Nm
+creates (or reinitializes) a git repository at
+.Ar directory
+and grants the owner and all other specified users write access to it.
+Access rights are stored in POSIX Access Control Lists as per
+.Xr acl 5 .
+.Pp
+It is safe to run this command on an already existing git repository.
+Previously unauthorized users that are included in the subsequent
+invocation will be granted write access.
+.Pp
+.Nm
+only ever grants access.
+If you need to remove access for a user, use the following
+invocation of
+.Xr setfacl 1
+instead:
+.Bd -literal -offset indent
+setfacl -Rnx 'u:<user>,d:u:<user>' <repository>
+.Ed
+.Sh SEE ALSO
+.Xr getfacl 1 ,
+.Xr git 1 ,
+.Xr git-init 1 ,
+.Xr setfacl 1 ,
+.Xr acl 5
+.Sh AUTHORS
+.An -nosplit
+.Nm
+was written by
+.An Wolfgang Müller Aq Mt wolf@oriole.systems .