Usage - Description - Example - Options - Return codes
create [log logfile] [options] file [...]
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.
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
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. |
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 |