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.10							    25 Mar 2002 							  creat(2)