Return to creat.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/creat.2, revision 1.1

1.1     ! root        1: .TH CREAT 2 "2 July 1983"
        !             2: .UC 4
        !             3: .SH NAME
        !             4: creat \- create a new file
        !             5: .SH SYNOPSIS
        !             6: .nf
        !             7: .B creat(name, mode)
        !             8: .B char *name;
        !             9: .fi
        !            10: .SH DESCRIPTION
        !            11: .B "This interface is obsoleted by open(2).
        !            12: .PP
        !            13: .I Creat
        !            14: creates a new file or prepares to rewrite an existing
        !            15: file called 
        !            16: .IR name ,
        !            17: given as the address of a null-terminated string.
        !            18: If the file did not exist, it is given
        !            19: mode
        !            20: .IR mode ,
        !            21: as modified by the process's mode mask (see
        !            22: .IR umask (2)).
        !            23: Also see
        !            24: .IR  chmod (2)
        !            25: for the
        !            26: construction of the
        !            27: .I mode
        !            28: argument.
        !            29: .PP
        !            30: If the file did exist, its mode and owner remain unchanged
        !            31: but it is truncated to 0 length.
        !            32: .PP
        !            33: The file is also opened for writing, and its file descriptor
        !            34: is returned.
        !            35: .SH NOTES
        !            36: The
        !            37: .I mode
        !            38: given is arbitrary; it need not allow
        !            39: writing.
        !            40: This feature has been used in the past by
        !            41: programs to construct a simple exclusive locking
        !            42: mechanism.  It is replaced by the O_EXCL open
        !            43: mode, or 
        !            44: .IR flock (2)
        !            45: facilitity.
        !            46: .SH "RETURN VALUE
        !            47: The value \-1 is returned if an error occurs.  Otherwise,
        !            48: the call returns a non-negative descriptor which only permits
        !            49: writing.
        !            50: .SH ERRORS
        !            51: .I Creat
        !            52: will fail and the file will not be created or truncated
        !            53: if one of the following occur:
        !            54: .TP 15
        !            55: [EPERM]
        !            56: The argument contains a byte with the high-order bit set.
        !            57: .TP 15
        !            58: [ENOTDIR]
        !            59: A component of the path prefix is not a directory.
        !            60: .TP 15
        !            61: [EACCES]
        !            62: A needed directory does not have search permission.
        !            63: .TP 15
        !            64: [EACCES]
        !            65: The file does not exist and the directory
        !            66: in which it is to be created is not writable.
        !            67: .TP 15
        !            68: [EACCES]
        !            69: The file exists, but it is unwritable.
        !            70: .TP 15
        !            71: [EISDIR]
        !            72: The file is a directory.
        !            73: .TP 15
        !            74: [EMFILE]
        !            75: There are already too many files open.
        !            76: .TP 15
        !            77: [EROFS]
        !            78: The named file resides on a read-only file system.
        !            79: .TP 15
        !            80: [ENXIO]
        !            81: The file is a character special or block special file, and
        !            82: the associated device does not exist.
        !            83: .TP 15
        !            84: [ETXTBSY]
        !            85: The file is a pure procedure (shared text) file that is being
        !            86: executed.
        !            87: .TP 15
        !            88: [EFAULT]
        !            89: .I Name
        !            90: points outside the process's allocated address space.
        !            91: .TP 15
        !            92: [ELOOP]
        !            93: Too many symbolic links were encountered in translating the
        !            94: pathname.
        !            95: .TP 15
        !            96: [EOPNOTSUPP]
        !            97: The file was a socket (not currently implemented).
        !            98: .SH "SEE ALSO"
        !            99: open(2), write(2), close(2), chmod(2), umask(2)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.