diff options
author | Mattias Andrée <maandree@kth.se> | 2017-12-11 23:13:37 +0100 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2017-12-11 23:13:37 +0100 |
commit | e35ba8684be9951fa2129503477ccd5ed6e4e5fc (patch) | |
tree | 756292d5a18ad6011a9311fdea8159f474385b65 /bus_chmod.3 | |
parent | typo (diff) | |
download | bus-01857be159c44428ef738590c9d2370bb2204247.tar.gz bus-01857be159c44428ef738590c9d2370bb2204247.tar.bz2 bus-01857be159c44428ef738590c9d2370bb2204247.tar.xz |
Simplify, do not install examples or info manual, and change license3.1.7
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'bus_chmod.3')
-rw-r--r-- | bus_chmod.3 | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/bus_chmod.3 b/bus_chmod.3 new file mode 100644 index 0000000..ab8cb14 --- /dev/null +++ b/bus_chmod.3 @@ -0,0 +1,56 @@ +.TH BUS_CHMOD 3 BUS +.SH NAME +bus_chmod - Change bus mode bits +.SH SYNOPSIS +.LP +.nf +#include <bus.h> +.P +int bus_chmod(const char *\fIfile\fP, mode_t \fImode\fP); +.fi +.SH DESCRIPTION +The +.BR bus_chmod () +function gives 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. +.PP +The current permissions of a bus can be retrieved by running +.BR stat (3) +over the \fIpathname\fP of the bus. +.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 +.BR bus-create (1), +.BR bus (5), +.BR libbus (7), +.BR bus_open (3), +.BR bus_read (3), +.BR stat (3) |