CREAT(2) HP Integral PC CREAT(2) CREAT(2) HP Integral PC CREAT(2) CREAT(2) HP Integral PC CREAT(2) CREAT(2) HP Integral PC CREAT(2) NAME NAME NAME NAME creat - create a new file or rewrite an existing one SYNOPSIS SYNOPSIS SYNOPSIS SYNOPSIS int creat (path, mode) char *path; int mode; DESCRIPTION DESCRIPTION DESCRIPTION DESCRIPTION Creat 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. Otherwise, the file's owner ID is set to the process's effective user ID, the file's group ID is set to the process's effective group ID, and the low-order 12 bits of the file mode are set to the value of mode modified as follows: All bits set in the process's file mode creation mask are cleared. See umask (2). The ``save text image after execution bit'' of the mode is cleared. See chmod (2). Upon successful completion, a non-negative integer, namely the 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 system calls. See fcntl (2). No process may have more than 20 files open simultaneously. A new file may be created with a mode that forbids writing. Creat will fail if one or more of the following are true: A component of the path prefix is not a directory. [ENOTDIR] A component of the path prefix does not exist. [ENOENT] Search permission is denied on a component of the path prefix. [EACCES] The path name is null. [ENOENT] The file does not exist and the directory in which the file is to be created does not permit writing. [EACCES] The named file resides or would reside on a read-only Hewlett-Packard - 1 - (printed 12/11/84) CREAT(2) HP Integral PC CREAT(2) CREAT(2) HP Integral PC CREAT(2) CREAT(2) HP Integral PC CREAT(2) CREAT(2) HP Integral PC CREAT(2) file system. [EROFS] The file is a pure procedure (shared text) file that is being executed. [ETXTBSY] The file exists and write permission is denied. [EACCES] The named file is an existing directory. [EISDIR] Twenty (20) file descriptors are currently open. [EMFILE] Path points outside the process's allocated address space. [EFAULT] RETURN VALUE RETURN VALUE RETURN VALUE RETURN VALUE Upon successful completion, a non-negative integer, namely the file descriptor, is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error. DIAGNOSTICS DIAGNOSTICS DIAGNOSTICS DIAGNOSTICS A file does not exist on the disc for which it is intended until a close operation is performed. SEE ALSO SEE ALSO SEE ALSO SEE ALSO close(2), dup(2), lseek(2), open(2), read(2), umask(2), write(2). Hewlett-Packard - 2 - (printed 12/11/84)