System Calls                                             creat(2)

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

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

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

DESCRIPTION
     The creat() function creates a new ordinary file or prepares
     to  rewrite  an existing file named by the path name pointed
     to by path.

     If the file exists, the length is truncated  to  0  and  the
     mode and owner are unchanged.

     If the file does not exist the file's owner ID is set to the
     effective  user  ID of the process. The group ID of the file
     is set to the effective group ID of the process, or  if  the
     S_ISGID bit is set in the parent directory then the group ID
     of the file is inherited from the  parent  directory.    The
     access permission bits of the file mode are set to the value
     of mode modified as follows:

        o  If the group ID of the new file  does  not  match  the
           effective  group  ID or one of the supplementary group
           IDs, the S_ISGID bit is cleared.

        o  All bits set in the process's file mode creation  mask
           (see  umask(2))  are  correspondingly  cleared  in the
           file's permission mask.

        o  The "save text image after execution bit" of the  mode
           is cleared (see chmod(2) for the values of mode).

     Upon successful completion,  a write-only file descriptor is
     returned  and the file is open for writing, even if the mode
     does not permit writing. The file  pointer  is  set  to  the
     beginning of the file.  The file descriptor is set to remain
     open across exec functions (see fcntl(2)).  A new  file  may
     be created with a mode that forbids writing.

     The call creat(path, mode) is equivalent to:

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

RETURN VALUES
     Upon   successful   completion,   a   non-negative   integer
     representing  the  lowest numbered unused file descriptor is

SunOS 5.8           Last change: 28 Jan 1998                    1

System Calls                                             creat(2)

     returned. Otherwise, -1 is returned, no files are created or
     modified, and errno is set to indicate the error.

ERRORS
     The creat() function will fail:

     EACCES
           Search permission is denied on a component of the path
           prefix;  the  file does not exist and the directory in
           which the file is to be created does not permit  writ-
           ing;  or  the  file  exists  and  write  permission is
           denied.

     EAGAIN
           The file exists, mandatory file/record locking is set,
           and  there  are  outstanding  record locks on the file
           (see chmod(2)).

     EDQUOT
           The directory where the new file entry is being placed
           cannot  be  extended  because the user's quota of disk
           blocks on that file system has been exhausted, or  the
           user's  quota  of  inodes on the file system where the
           file is being created has been exhausted.

     EFAULT
           The path argument points to an illegal address.

     EINTR A signal  was  caught  during  the  execution  of  the
           creat() function.

     EISDIR
           The named file is an existing directory.

     ELOOP Too many symbolic links were encountered in  translat-
           ing path.

     EMFILE
           The   process   has   too   many   open   files   (see
           getrlimit(2)).

     ENFILE
           The system file table is full.

     ENOENT
           A component of the path prefix does not exist, or  the
           path name is null.

     ENOLINK
           The path argument points to a remote machine  and  the
           link to that machine is no longer active.

SunOS 5.8           Last change: 28 Jan 1998                    2

System Calls                                             creat(2)

     ENOSPC
           The file system is out of inodes.

     ENOTDIR
           A component of the path prefix is not a directory.

     EOVERFLOW
           The file is a large file at the time of creat().

     EROFS The named file resides or would reside on a  read-only
           file system.

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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|

SEE ALSO
     chmod(2),   close(2),   dup(2),   fcntl(2),    getrlimit(2),
     lseek(2),   open(2),  read(2),  umask(2),  write(2),  attributes(5)
     , largefile(5),  lf64(5), stat(5)

SunOS 5.8           Last change: 28 Jan 1998                    3