aboutsummaryrefslogtreecommitdiffstats
path: root/doc/bus_create.3
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--doc/bus_create.37
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