aboutsummaryrefslogtreecommitdiffstats
path: root/git-init-acl.1
diff options
context:
space:
mode:
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 .