queue-pr(8)       GNATS Administration Utilities      queue-pr(8)



NAME
       queue-pr - incoming mail control for GNATS

SYNOPSIS
       queue-pr  [ -q | --queue ] [ -r | --run ]
                 [ -f filename | --file=filename ]
                 [ -m kbytes | --max-size=kbytes ]
                 [ -d database | --database=database ]
                 [ -h | --help ] [ -V | --version ]

DESCRIPTION
       `queue-pr  -q'  should run through a pipe(2V) via the mail
       aliases(5) mechanism to automatically place  incoming  bug
       reports in a queue directory for GNATS.

       Run  `queue-pr  -r'  via cron(8) to periodically empty the
       GNATS queue, filing new bug reports in the database.

       Always use one of -q | --queue or  -r  |  --run  (but  not
       both),  in  each call to queue-pr.  These are mutually ex-
       clusive functions in order to avoid collisions.

OPTIONS
       -q, --queue
                 Accept standard input as an incoming  mail  mes-
                 sage,  placing  this message in an incrementally
                 numbered  file  in  the  database   subdirectory
                 gnats-queue for future handling.

       -r, --run Redirect  files  from  the database subdirectory
                 gnats-queue to file-pr(8) which files  and  cre-
                 ates index entries for each.

       -f filename or --file=filename
                 Treat filename as input rather than reading from
                 standard input (used with the --queue option).

       -m kbytes, --max-size=kbytes
                 Do not process messages larger than kbytes kilo-
                 bytes  in size.  Files larger than the limit are
                 left for human intervention.

       -d database or --database=databasename
                 Used with the --queue or --run options, use  the
                 database named database rather than the database
                 default or the database specified by the GNATSDB
                 environment variable.

       -h, --help
                 Displays a short usage message.

       -V, --version
                 Displays the queue-pr version number.

ENVIRONMENT VARIABLES
       The  GNATSDB  environment  variable  is  used to determine
       which database to use.  For a local database, it  contains
       the  name  of  the  database to access.  If GNATSDB is not
       set, the database named default is used.

SEE ALSO
       Keeping Track: Managing  Messages  With  GNATS  (also  in-
       stalled as the GNU Info file gnats.info)

       databases(5),  dbconfig(5), delete-pr(8), edit-pr(1) file-
       pr(8),  gen-index(8),   gnats(7),   gnatsd(8),   mkcat(8),
       mkdb(8), pr-edit(8), query-pr(1), queue-pr(8), send-pr(1).

COPYING
       Copyright (c) 1993, 2003, Free Software Foundation, Inc.

       Permission is granted  to  make  and  distribute  verbatim
       copies  of  this  manual provided the copyright notice and
       this permission notice are preserved on all copies.

       Permission is granted to copy and distribute modified ver-
       sions  of  this  manual  under the conditions for verbatim
       copying, provided that the entire resulting  derived  work
       is  distributed  under  the  terms  of a permission notice
       identical to this one.

       Permission is granted to copy and distribute  translations
       of this manual into another language, under the above con-
       ditions for modified versions, except that this permission
       notice  may  be  included  in translations approved by the
       Free Software Foundation instead of in  the  original  En-
       glish.



GNATS                      August 2003                queue-pr(8)