RUNQ(8)                                                   RUNQ(8)

     NAME
          runq - process all requests in a queue

     SYNOPSIS
          runq [ -ad ] root cmd

     DESCRIPTION
          Without the -a option, runq processes all requests in the
          directory root/user, where user is the contents of
          /dev/user.  A request is defined as a control and a data
          file (see qer(8)). The request is processed by executing the
          command cmd with the contents of the control file as its
          arguments, the contents of the data file as its standard
          input, and standard error appended to the error file
          E.XXXXXX.

          The action taken by runq depends on the return status of
          cmd. If cmd returns a null status, the processing is assumed
          successful and the control, data, and error files are
          removed.  If cmd returns an error status containing the word
          `Retry', the files are left to be reprocessed at a later
          time.  For any other status, an error message is mailed to
          the requester and the files are removed.

          To avoid reprocessing files too often, the following algo-
          rithm is used: a data file younger than one hour will not be
          processed if its error file exists and was last modified
          within the preceding 10 minutes.  A data file older than one
          hour will not be processed if its error file exists and was
          last modified within the preceding hour.

          The -a option forces runq to process all the requests under
          the root, not just a single user's.

          The -d option causes debugging output on standard error
          describing the progress through the queues.

     FILES
          root/user           queue directory for user
          root/user/D.XXXXXX  data file
          root/user/C.XXXXXX  control file
          root/user/E.XXXXXX  error file

     SEE ALSO
          qer(8)

     Page 1                       Plan 9             (printed 3/29/24)