Return to creat.2 CVS log

Up to [Research Unix] / researchv10dc / dist / man / v4 / man2

Annotation of researchv10dc/dist/man/v4/man2/creat.2, revision 1.1.1.1

1.1       root        1: .th CREAT II 8/5/73
                      2: .sh NAME
                      3: creat  \*-  create a new file
                      4: .sh SYNOPSIS
                      5: (creat = 8.)
                      6: .br
                      7: .ft B
                      8: sys creat; name; mode
                      9: .br
                     10: (file descriptor in r0)
                     11: .s3
                     12: creat(name, mode)
                     13: .br
                     14: char *name;
                     15: .ft R
                     16: .sh DESCRIPTION
                     17: .it Creat
                     18: creates a new file or prepares to rewrite an existing
                     19: file called 
                     20: .it name,
                     21: given as the address of a null-terminated string.
                     22: If the file did not exist, it is given
                     23: mode
                     24: .it mode.
                     25: See
                     26: chmod(II) for the
                     27: construction of the
                     28: .it mode
                     29: argument.
                     30: .s3
                     31: If the file did exist, its mode and owner remain unchanged
                     32: but it is truncated to 0 length.
                     33: .s3
                     34: The file is also opened for writing, and its file descriptor
                     35: is returned (in r0).
                     36: .s3
                     37: The
                     38: .it mode
                     39: given is arbitrary; it need not allow
                     40: writing.
                     41: This feature is used by programs which deal with temporary
                     42: files of fixed names.
                     43: The creation is done with
                     44: a mode that forbids writing.
                     45: Then if a second
                     46: instance of the program attempts a
                     47: .it creat,
                     48: an error is
                     49: returned and the program knows that the name is unusable
                     50: for the moment.
                     51: .sh "SEE ALSO"
                     52: write(II), close(II), stat(II)
                     53: .sh DIAGNOSTICS
                     54: The error bit
                     55: (c-bit) may be set if: a needed directory is not searchable;
                     56: the file does not exist and the directory
                     57: in which it is to be created is not writable; the file
                     58: does exist and is unwritable;
                     59: the file is a directory;
                     60: there are already 10 files open.
                     61: .s3
                     62: From C, a \*-1 return indicates an error.

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