opensolaris man page for creat

creat(2)							   System Calls 							  creat(2)

NAME
       creat - create a new file or rewrite an existing one

SYNOPSIS
       #include <sys/stat.h>
       #include <fcntl.h>

       int creat(const char *path, mode_t mode);

DESCRIPTION
       The function call

       creat(path, mode)

       is equivalent to:

       open(path, O_WRONLY | O_CREAT | O_TRUNC, mode)

RETURN VALUES
       Refer to open(2).

ERRORS
       Refer to open(2).

EXAMPLES
       Example 1 Creating a File

       The  following example creates the file /tmp/file with read and write permissions for the file owner and read permission for group and oth-
       ers. The resulting file descriptor is assigned to the fd variable.

	 #include <fcntl.h>
	 ...
	 int fd;
	 mode_t mode = S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH;
	 char *filename = "/tmp/file";
	 ...
	 fd = creat(filename, mode);
	 ...

USAGE
       The creat() function has a transitional interface for 64-bit file offsets.  See lf64(5).

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe 	   |
       +-----------------------------+-----------------------------+

SEE ALSO
       open(2), attributes(5), largefile(5), lf64(5), standards(5)

SunOS 5.11							    25 Mar 2002 							  creat(2)