query-pr
Section: GNATS User Utilities (1)
Updated: April 1993
Index
Return to Main Contents
NAME
query-pr - query problem reports in the
GNATS
database
SYNOPSIS
query-pr
-
[
gnats-id
]
[
-i | --sql
] [
-F | --full
]
[
-d directory | --directory=directory
]
[
-c category | --category=category
]
[
-S submitter | --submitter=submitter
]
[
-r responsible | --responsible=responsible
]
[
-s state | --state=state
]
[
-C [yes|no] | --confidential=[yes|no]
]
[
-e severity | --severity=severity
]
[
-p priority | --priority=priority
]
[
-O name | --originator=name
]
[
-o outfile | --output=outfile
]
[
-q | --summary
]
[
-V | --version
]
[
-h | --help
]
DESCRIPTION
Queries the
GNATS
database according to options and displays bugreports on standard output.
Using the argument displays the bug report
gnats-id.
send-pr
with no options or arguments yields summary information for every report
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
- -i, --sql
-
Prints data in a format readable by a relational database (see
gnats.texi
for a full explanation).
- -F, --full
-
Prints the full Problem Report rather than just a summary.
- -d directory, --directory=directory
-
Changes the search directory to
directory.
- -c category, --category=category
-
Search only for PRs with a
>Category:
field of
category.
- -S submitter, --submitter=submitter
-
Search only for PRs with a
>Submitter-Id:
field of
submitter.
- -r responsible, --responsible=responsible
-
Search only for PRs with a
>Responsible:
field of
responsible.
- -s state, --state=state
-
Search only for PRs with a
>State:
field of
state.
- -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.
- -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" to match against it.
It's suggested that you use another search option (e.g., against
state), to accelerate the speed of the search. Using
-O
by itself can tend to be slow with a large database. Note 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.
- -p priority, --priority=priority
-
Search only for PRs with a
>Priority:
field of
priority.
- -o outfile, --output=outfile
-
Print all output to
outfile
rather than to the standard output.
- -q, --summary
-
Give a short summary line for PRs.
- -V, --version
-
Prints the version number of
send-pr.
-h, --help
Prints a brief usage summary.
SEE ALSO
gnats.texi
and
send-pr.texi,
which are also installed as GNU
Info
files
gnats.info
and
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.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- SEE ALSO
-
- COPYING
-
This document was created by
man2html,
using the manual pages.
Time: 07:48:55 GMT, May 19, 2025