iRMX C Library Reference - tenAsys

stdio creat
creat
Syntax
Creates a new file and opens it for writing in the specified permission mode or opens
an existing file for writing and truncates it to length 0, destroying the previous
contents.
#include
#include
#include
int creat (const char *filename, mode_t pmode);
Parameters
filename
Pathname of file to be opened for writing.
pmode Permission mode, one or more of the manifest constants described in chmod( ). Join
multiple constants with the bitwise-OR operator (|). Applies to newly created files
only.
Additional Information
Returns
The creat( ) function applies the default file-permission mask (set with the umask( )
function) to pmode before setting the permissions. A new file receives the specified
ownership and access rights after it is closed for the first time.
By default, files opened by this function are sharable by all tasks. If O_EXCL is
ORed with pmode, the file is opened with share-with-none permission, like UNIX.
This function translates POSIX file ownership rights and access rights as described in
chmod( ).
See also: chmod( ), chsize( ), close( ), dup( ), dup2( ), open( ), sopen( ), umask( )
A descriptor for the created file.
-1 and sets errno to one of these values if unsuccessful:
EACCES Pathname specifies an existing read-only file or specifies a directory
instead of a file.
EMFILE No more file descriptors available (too many open files).
C Library Reference Chapter 3 51