CREAT(3C)               COMMAND REFERENCE               CREAT(3C)



NAME
     creat - create a new file

SYNOPSIS
     fd = creat(pathname, mode)
     int fd;
     char *pathname;
     int mode;

DESCRIPTION
          Note: This interface is made obsolete by open(2).

     Creat creates a new file or prepares to rewrite an existing
     file whose pathname is pathname. A file descriptor for the
     file is returned in fd.  If the file does not exist, it is
     given mode mode, as modified by the process's mode mask (see
     umask(2)).  Also see chmod(2) for the construction of the
     mode argument.

     If the file does exist, its mode and owner remain unchanged
     but it is truncated to zero length; the file is also opened
     for writing.

DIAGNOSTICS
     Creat will fail and the file will not be created or
     truncated if one of the following occur:

     [ENOASCII]
         The argument contains a byte with the high-order bit
         set.

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

     [EACCES]
         A needed directory does not have search permission.

     [EACCES]
         The file does not exist and the directory in which it is
         to be created is not writable.

     [EACCES]
         The file exists, but it is unwritable.

     [EISDIR]
         The file is a directory.

     [EMFILE]
         NOFILE files are already open.

     [EROFS]
         The named file resides on a read-only file system.



Printed 10/17/86                                                1

CREAT(3C)               COMMAND REFERENCE               CREAT(3C)



     [ENOSPC]
         The directory in which the entry for the new file is
         being placed cannot be extended because there is no
         space left on the file system containing the directory.

     [ENOENT]
         A component of the pathname which must exist does not
         exist.

     [EIO]
         An I/O error occurred while reading from or writing to
         the file system.

     [ENXIO]
         The file is a character special or block special file,
         and the associated device does not exist.

     [ETXTBSY]
         The file is a pure procedure (shared text) file that is
         being executed.

     [EFAULT]
         Pathname points outside the process's allocated address
         space.

     [ELOOP]
         Too many symbolic links were encountered in translating
         the pathname.

     [EOPNOTSUPP]
         The file is a socket (not currently implemented).

RETURN VALUE
     [-1]             This value is returned if an error occurs.

     If there is no error, the call returns a nonnegative
     descriptor which only permits writing.

SEE ALSO
     open(2), chmod(2), close(2), umask(2), unlink(2), write(2).















Printed 10/17/86                                                2

%%index%%
na:72,61;
sy:133,445;
de:578,769;
di:1347,818;2309,926;
rv:3235,248;
se:3483,200;
%%index%%000000000115