aboutsummaryrefslogtreecommitdiffstats
path: root/bus_chown.3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2017-12-11 23:13:37 +0100
committerMattias Andrée <maandree@kth.se>2017-12-11 23:13:37 +0100
commite35ba8684be9951fa2129503477ccd5ed6e4e5fc (patch)
tree756292d5a18ad6011a9311fdea8159f474385b65 /bus_chown.3
parenttypo (diff)
downloadbus-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_chown.3')
-rw-r--r--bus_chown.343
1 files changed, 43 insertions, 0 deletions
diff --git a/bus_chown.3 b/bus_chown.3
new file mode 100644
index 0000000..d90b131
--- /dev/null
+++ b/bus_chown.3
@@ -0,0 +1,43 @@
+.TH BUS_CHOWN 3 BUS
+.SH NAME
+bus_chown - Change bus owner and group
+.SH SYNOPSIS
+.LP
+.nf
+#include <bus.h>
+.P
+int bus_chown(const char *\fIfile\fP, uid_t \fIowner\fP, gid_t \fIgroup\fP);
+.fi
+.SH DESCRIPTION
+The
+.BR bus_chown ()
+function changes the owner and the group of the bus associated with
+\fIfile\fP to the \fIowner\fP and \fIgroup\fP, respectively.
+.PP
+The current ownership 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 chown (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)