query-pr(1) GNATS 3.2 (October 1993) 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 ]
[ -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 ]
[ -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 particu-
lar PR numbers (with the gnats-id... arguments), query-pr
restricts its search to only those PRs. Using query-pr with
no options or gnats-id ... arguments 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.
-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 sub-
mitter.
Page 1 (printed 3/19/99)
query-pr(1) GNATS 3.2 (October 1993) query-pr(1)-C [yes|no], --confidential[=yes|no]
Search only for PRs with a >Confidential: field of ei-
ther yes or no, respectively. If this option is not
given, all PRs will be eligible for the search, regard-
less of their confidentiality.
-e severity, --severity=severity
Search only for PRs with a >Severity: field of severi-
ty.
-p priority, --priority=priority
Search only for PRs with a >Priority: field of priori-
ty.
-O name, --originator=name
Search for name in the >Originator: field of each PR.
name need only be enough to uniquely identify the per-
son. 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 it-
self can be slow with a large database. You must en-
close 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 regu-
lar 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 sum-
mary.
-q, --summary
Give a short summary line for PRs.
-i, --sql
Prints data in a format readable by a relational data-
base (see the GNATS manual Keeping Track for a full ex-
planation).
-P, --print-path
Page 2 (printed 3/19/99)
query-pr(1) GNATS 3.2 (October 1993) query-pr(1)
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 Re-
ports 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 Us-
ing 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 per-
mission notice are preserved on all copies.
Permission is granted to copy and distribute modified ver-
sions of this manual under the conditions for verbatim copy-
ing, provided that the entire resulting derived work is dis-
tributed under the terms of a permission notice identical to
this one.
Permission is granted to copy and distribute translations of
Page 3 (printed 3/19/99)
query-pr(1) GNATS 3.2 (October 1993) query-pr(1)
this manual into another language, under the above condi-
tions for modified versions, except that this permission no-
tice may be included in translations approved by the Free
Software Foundation instead of in the original English.
Page 4 (printed 3/19/99)