aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man/bus_chown.3
blob: c047d837b952d96d6cfd3776a375699af8895ddd (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
.TH BUS_CHOWN 3 BUS-%VERSION%
.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)
.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