NEWFILE(1) K-Spool by Xinet (13 Oct 1997 8.2) NEWFILE(1)
NAME
newfile - perform file-creation tasks for printer scripts
SYNOPSIS
/usr/etc/appletalk/newfile [ -d ] [ -s size ] [ -f name ] [ -p ptr ] [ -s sfx ] dir
/usr/etc/appletalk/newfile -b file
/usr/etc/appletalk/newfile -a file
DESCRIPTION
The newfile program creates a new file with the prefix name
(default: out) in the directory dir, but waits until there
is enough available free disk space in the directory. The
actual file created will have the pathname dir/name###sfx,
where ### is a unique three-digit number; i.e. newfile will
not overwrite an existing file. The default for sfx is to
not append anything. The final complete pathname will be
written on standard output.
If the -d argument is given, newfile restricts the last
component of the pathname to DOS limitations (all upper
case, 8.3 characters). In that case, the ###
differentiating number will not be included unless there is
a filename conflict. The ptr argument specifies a printer
the file is being made for, and the -d and sfx arguments may
be read from that printer's printcap entry.
Newfile waits until the filesystem containing dir has at
least size bytes (default: 524288) available space. The
directory dir will also be checked for the file minfree,
which can contain a number of Kilobytes of additional
freespace that newfile will wait for before creating the new
file. If newfile has to wait to create a new file, it will
report the delay to the AppleTalk log,
/usr/adm/appletalk/atlog. It will also report delays, as
well as success to an existing status file in the current
directory. It will not create the status file.
The newfile program performs two additional tasks: with the
-b option, it will print the size of file in bytes. With
the -a option, it will print the age of file in seconds past
its modification time.
DIAGNOSTICS
Newfile exits with status 1 when it cannot read a file, or
if command-line options have the wrong syntax. It exits
with status 2 if it cannot create the requested new file.
FILES
current_working_directory/status
printer status is written here, if it exists
/usr/adm/appletalk/at_log
Page 1 (printed 3/5/98)
NEWFILE(1) K-Spool by Xinet (13 Oct 1997 8.2) NEWFILE(1)
delays waiting for free space are reported here.
Page 2 (printed 3/5/98)