.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 who have 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 mixed, 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