aboutsummaryrefslogblamecommitdiffstats
path: root/doc/bus_chown.3
blob: 186e9375f583e0d80ef0cd72ecdf69c742f47fb1 (plain) (tree)
1
2
3
4
5
6
7
8
9
10



                                      

   
                


                                                                            
               



                                                                  




                                                                  
                 

                                                   



                 
   
              

                                                          
               
            




                   







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