.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)