aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man/bus-chmod.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/bus-chmod.1')
-rw-r--r--doc/man/bus-chmod.149
1 files changed, 49 insertions, 0 deletions
diff --git a/doc/man/bus-chmod.1 b/doc/man/bus-chmod.1
new file mode 100644
index 0000000..24f97e6
--- /dev/null
+++ b/doc/man/bus-chmod.1
@@ -0,0 +1,49 @@
+.TH BUS-CHMOD 1 BUS-%VERSION%
+.SH NAME
+bus chmod - Change permissions on a bus
+.SH SYNOPSIS
+.B bus chmod
+[--]
+.IR permissions
+.IR pathname
+.SH DESCRIPTION
+Change whom as access to a bus with an associated \fIpathname\fP.
+In the \fIpermissions\fP, the owner, the group, and others (not
+in group) are represented by the symbols \fBu\fP, \fBg\fP, and
+\fBo\fP, respectively. The \fIpermissions\fP string is imagined
+to have always be prefixed with an \fB=\fP. This symbols means
+that all user classes list after it, and only those classes, as
+permission to use the bus. Similarly the symbols \fB+\fP and
+\fB\-\fP can be used to grant and revoke access, respectively.
+The symbols \fB=\fP, \fB+\fP, and \fB\-\fP can be maked, and are
+interpreted from left to right. Alternatively the \fIpermissions\fP
+string can be a octal number, where the owner is represented by any
+bit in 700 (100, 200, or 400, or any combination thereof), the
+group is represented by any bit in 70, and others (not in the group)
+is represented by any bit in 7.
+.PP
+The current permissions of a bus can be retrieved by running
+.BR stat (1)
+over the \fIpathname\fP of the bus.
+.SH EXIT STATUS
+.TP
+0
+The command was successful.
+.TP
+1
+The command failed.
+.TP
+2
+The command is not recognised.
+.SH SEE ALSO
+.BR bus-chown (1),
+.BR bus-chgrp (1),
+.BR stat (1)
+.SH AUTHORS
+Principal author, Mattias Andrée. See the LICENSE file for the full
+list of authors.
+.SH LICENSE
+MIT/X Consortium License.
+.SH BUGS
+Please report bugs to https://github.com/maandree/bus/issues or to
+maandree@member.fsf.org