query-pr

query-pr(1)                  GNATS User Utilities                  query-pr(1)



NAME
       query-pr - query problem reports in the GNATS database

SYNOPSIS
       query-pr
              [ -c category | --category=category ]
              [ -s state | --state=state ]
              [ -r responsible | --responsible=responsible ]
              [ -S submitter | --submitter=submitter ]
              [ -x | --skip-closed ]
              [ -C [yes|no] | --confidential[=yes|no] ]
              [ -e severity | --severity=severity ]
              [ -p priority | --priority=priority ]
              [ -O name | --originator=name ]
              [ -t text | --text=text ]
              [ -m text | --multitext=text ]
              [ -R | --restricted ] [ -E | --entire ]
              [ -F | --full ] [ -q | --summary ] [ -i | --sql ]
              [ -P | --print-path ]
              [ -d directory | --directory=directory ]
              [ -o outfile | --output=outfile ]
              [ -V | --version ]
              [ -h | --help ]
              [ gnats-id ...  ]


DESCRIPTION
       Queries the GNATS database according to options and displays Problem
       Reports on standard output.  If you specify particular PR numbers (with
       the gnats-id...  arguments), query-pr restricts its search to only
       those PRs.  Using query-pr with the -E or --entire options displays a
       summary of every PR in the database.

       All options are connected with a logical AND.  For example,
              query-pr --category=category --responsible=responsible
       only prints PRs which have a >Category: field of category and a
       >Responsible: field of responsible.

OPTIONS
       -c category, --category=category
            Search only for PRs with a >Category: field of category.

       -s state, --state=state
            Search only for PRs with a >State: field of state.

       -x, --skip-closed
            Search only for PRs in states other than closed.

       -r responsible, --responsible=responsible
            Search only for PRs with a >Responsible: field of responsible.

       -S submitter, --submitter=submitter
            Search only for PRs with a >Submitter-Id: field of submitter.

       -C [yes|no], --confidential[=yes|no]
            Search only for PRs with a >Confidential: field of either yes or
            no, respectively.  If this option is not given, all PRs will be
            eligible for the search, regardless of their confidentiality.

       -e severity, --severity=severity
            Search only for PRs with a >Severity: field of severity.

       -p priority, --priority=priority
            Search only for PRs with a >Priority: field of priority.

       -O name, --originator=name
            Search for name in the >Originator: field of each PR.  name need
            only be enough to uniquely identify the person.  For example, to
            find "Steve Williams" you could use a name of "Steve W".  Use
            another search option (e.g.  --state), to speed the search.  Using
            -O by itself can be slow with a large database.  You must enclose
            the name with double-quotes to make sure your shell passes it as a
            single string, and not as separate arguments to query-pr.

       -t text, --text=text
            Search single-line text fields in all PRs for the regular
            expression text.

       -m text, --multitext=text
            Search multiple-line text fields in all PRs for the regular
            expression text.

       -R, --restricted
            Omit from the search any PR marked >Confidential: yes.  This is
            equivalent to specifying --confidential=no.  This also disallows
            the use of the options
            --outfile=outfile and --directory=directory.

       -F, --full
            Prints the full Problem Report rather than just a summary.

       -q, --summary
            Give a short summary line for PRs.

       -i, --sql
            Prints data in a format readable by a relational database (see the
            GNATS manual Keeping Track for a full explanation).

       -P, --print-path
            Print the path used to find each PR.

       -d directory, --directory=directory
            Changes the search directory to directory.

       -o outfile, --output=outfile
            Print all output to outfile rather than to the standard output.

       -V, --version
            Prints the version number of query-pr.

       -h, --help
            Prints a brief usage summary.

QUERY BY MAIL
       query-pr can also be accessed by electronic mail, if your version of
       GNATS is configured for this.  To use this feature, simply send mail to
       the address query-pr@your-site with command line arguments or options
       in the Subject: line of the mail header.  GNATS replies to your mail
       with the results of your query.  The default settings for the query-pr
       mail server are shown below; to override the --state parameter, specify
       --state=state in the Subject: line of the mail header.  You can not
       query on confidential Problem Reports by mail.

       --restricted --state="open|analyzed|feedback|suspended"

SEE ALSO
       Keeping Track: Managing Messages With GNATS (also installed as the GNU
       Info file gnats.info) and Reporting Problems Using send-pr (also
       installed as the GNU Info file send-pr.info).

       gnats(l), send-pr(1), edit-pr(1), file-pr(8), queue-pr(8), mkcat(8),
       rmcat(8), gen-index(8), mkdist(8).

COPYING
       Copyright (c) 1993 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 versions 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 conditions for modified
       versions, except that this permission notice may be included in
       translations approved by the Free Software Foundation instead of in the
       original English.



GNATS 3.101                      October 1993                      query-pr(1)