diff options
Diffstat (limited to 'doc/bus_chmod.3')
| -rw-r--r-- | doc/bus_chmod.3 | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/doc/bus_chmod.3 b/doc/bus_chmod.3 new file mode 100644 index 0000000..c61fcd3 --- /dev/null +++ b/doc/bus_chmod.3 @@ -0,0 +1,50 @@ +.TH BUS_CHMOD 3 BUS-%VERSION% +.SH NAME +bus_chmod - Change bus mode bits +.SH SYNOPSIS +#include <bus.h> + +int bus_chmod(const char *file, mode_t mode); +.SH DESCRIPTION +The \fIbus_chmod()\fP function shall give access to the bus associated +with \fIfile\fP according to the following rules: +.TP +* +If (\fImode\fP &S_IRWXU) the owner should be given full access to +the bus. Otherwise the owner should have no access. +.TP +* +If (\fImode\fP &S_IRWXG) the group should be given read and write +access to the bus. Otherwise the group should have no access. +.TP +* +If (\fImode\fP &S_IRWXO) others (except the group) should be given +read and write access to the bus. Otherwise others should have no +access. +.SH RETURN VALUES +Upon successful completion, the function returns 0. Otherwise the +function returns -1 and sets \fIerrno\fP to indicate the error. +.SH ERRORS +The +.BR bus_chown(3) +function may fail and set \fIerrno\fP to any of the +errors specified for +.BR bus_open(3), +.BR chmod(3), +.BR semget(3), +.BR shmget(3) +and +.BR shmctl(3) +as well as any errors specified for the \fIIPC_STAT\fP and +\fIIPC_SET\fP commands for +.BR semctl(3). +.SH SEE ALSO +bus-create(1), bus(5), libbus(7), bus_open(3), bus_read(3) +.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 |