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/at_log.  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
               delays waiting for free space are reported here.