You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
23 lines
886 B
Groff
23 lines
886 B
Groff
.TH open_excl 3
|
|
.SH NAME
|
|
open_excl \- open a file for exclusive writing
|
|
.SH SYNTAX
|
|
.B #include <libowfat/open.h>
|
|
|
|
int \fBopen_excl\fP(const char *\fIfilename\fR);
|
|
.SH DESCRIPTION
|
|
open_excl opens the file \fIfilename\fR for writing and returns the file
|
|
handle. The file may not exist before the call to \fBopen_excl\fR. The
|
|
file will be created with mode 0600.
|
|
|
|
If there was an error creating the file, open_excl returns -1
|
|
and sets errno accordingly.
|
|
|
|
Since open_excl relies on the O_EXCL flag to open, it does not work
|
|
reliably over NFS (the NFS protocol is broken) and must be emulated
|
|
using a lock file (create a file with a unique file name and link(2) it
|
|
to the lock file. Then stat the lock file and see if the link count is
|
|
2).
|
|
.SH "SEE ALSO"
|
|
open(2), open_append(3), open_read(3), open_rw(3), open_trunc(3), open_write(3), openreadclose(3), readclose(3), readclose_append(3)
|