# CREATE v1.30 - create empty file(s)

#### Revised 23-Aug-97. Copyright (c) 1996-97 by Rune Berg. TextTools Freeware.

Usage - Description - Example - Options - Return codes

### USAGE

create [log logfile] [options] file [...]

### DESCRIPTION

create creates empty file(s), as named by the file argument(s).

For each file created, create prints the following message:

            create: file created

If file already exists, create will print an error message and exit (but see -o and -w options).

If file can not be created, create will print an error message and exit.

If you don't specify logfile, create writes error messages to standard error.

### EXAMPLE

For example (if files "xyz.txt" and "data.tst" do not already exist), the command:

            create xyz.txt data.tst

creates two files, "xyz.txt" and "data.tst", both empty, and prints these messages to standard error (or logfile, if given):

            create: xyz.txt created
            create: data.tst created

### OPTIONS

create recognizes the following command line options:

Option | Function
--- | ---
-o | Overwrite (truncate to length 0) a file that already exists, then continue.
-w | Warn if file already exists, don't create it, continue. (This is an alternative to the -o option.)
-q | Quiet mode, suppress creation reports and warnings. (Does not affect return codes.)
-n | Write a carriage-return and newline char. to each created file.
-z | Write a DOS end-of-file char. (hex 1a) to each created file.
-v | Print version banner and usage info to standard error (or logfile, if given), then exit.

### RETURN CODES

create returns with one of the following codes ("error levels"):

Code | Meaning
--- | ---
0 | Success
1 | Skipped creating existing file (warning, see -w option)
102 | Incorrect command line arguments
104 | Error opening file
105 | I/O error
107 | File name clash
109 | File already exists

##### End of document