diff options
Diffstat (limited to 'doc/bus_create.3')
| -rw-r--r-- | doc/bus_create.3 | 7 |
1 files changed, 4 insertions, 3 deletions
diff --git a/doc/bus_create.3 b/doc/bus_create.3 index 68d52cc..b30400e 100644 --- a/doc/bus_create.3 +++ b/doc/bus_create.3 @@ -6,13 +6,13 @@ bus_create - Create a new bus int bus_create(const char *file, int flags, char **out_file); .SH DESCRIPTION -The \fIbus_create\fP function shall create a bus with the asscoiated pathname specifed by the value of the parameter \fIfile\fP. If the \fIfile\iP is \fINULL\fP, a random pathname shall be selected. This random pathname must adhere to the convention set forth by bus(5). +The \fIbus_create\fP function shall create a bus with the asscoiated pathname specifed by the value of the parameter \fIfile\fP. If the \fIfile\fP is \fINULL\fP, a random pathname shall be selected. This random pathname must adhere to the convention set forth by bus(5). If \fIfile\fP is not \fINULL\fP, the \fIbus_create\fP function must fail if the file already exists if \fIflags\fP contains \fIBUS_EXCL\fP. Otherwise if \fIfile\fP is not \fINULL\fP, the \fIbus_create\fP function should do nothing if the file already exists. If and only if \fIflags\fP contains \fIBUS_INTR\fP, the function shall fail if it is interrupted. -Unless \fIout_file\fP is \fINULL\P, the pathname of the bus should be stored in a new char array stored in \fI*out_file\fP. The caller must free the allocated stored in \fI*out_file\fP. +Unless \fIout_file\fP is \fINULL\fP, the pathname of the bus should be stored in a new char array stored in \fI*out_file\fP. The caller must free the allocated stored in \fI*out_file\fP. .SH RETURN VALUES Upon successful completion, the function shall return 0. Otherwise the function shall return -1 and set \fIerrno\fP to indicate the error. .SH ERRORS @@ -20,8 +20,9 @@ Upon successful completion, the function shall return 0. Otherwise the function .IR ENOMEM The process cannot allocate more memory. .SH - +.BR The \fIbus_create\fP() function may also fail and set \fIerrno\fP to any of the errors specified for the rutines open(2) and write(2). +.BR .SH SEE ALSO bus-create(1), bus(5), libbus(7), bus_unlink(3), bus_open(3) .SH AUTHORS |