aboutsummaryrefslogtreecommitdiffstats
path: root/doc/bus_chown.3
diff options
context:
space:
mode:
Diffstat (limited to 'doc/bus_chown.3')
-rw-r--r--doc/bus_chown.334
1 files changed, 21 insertions, 13 deletions
diff --git a/doc/bus_chown.3 b/doc/bus_chown.3
index 86e9481..186e937 100644
--- a/doc/bus_chown.3
+++ b/doc/bus_chown.3
@@ -2,32 +2,40 @@
.SH NAME
bus_chown - Change bus owner and group
.SH SYNOPSIS
+.LP
+.nf
#include <bus.h>
-
-int bus_chown(const char *file, uid_t owner, gid_t group);
+.P
+int bus_chown(const char *\fIfile\fP, uid_t \fIowner\fP, gid_t \fIgroup\fP);
+.fi
.SH DESCRIPTION
-The \fIbus_chown()\fP function change the owner and the group of the bus
-associated with \fIfile\fP to the \fIowner\fP and \fIgroup\fP,
-respectively.
+The
+.BR bus_chown ()
+function change the owner and the group of the bus associated with
+\fIfile\fP to the \fIowner\fP and \fIgroup\fP, respectively.
.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)
+.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)
+.BR bus_open (3),
+.BR chown (3),
+.BR semget (3),
+.BR shmget (3)
and
-.BR shmctl(3)
+.BR shmctl (3)
as well as any errors specified for the \fIIPC_STAT\fP and
\fIIPC_SET\fP commands for
-.BR semctl(3).
+.BR semctl (3).
.SH SEE ALSO
-bus-create(1), bus(5), libbus(7), bus_open(3), bus_read(3)
+.BR bus-create (1),
+.BR bus (5),
+.BR libbus (7),
+.BR bus_open (3),
+.BR bus_read (3)
.SH AUTHORS
Principal author, Mattias Andrée. See the LICENSE file for the full
list of authors.