GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
edit-pr(1) GNATS User Utilities edit-pr(1)

edit-pr - edit a problem report in the GNATS database

edit-pr
[ -h | --help ] [ -V | --version ]
[ -d databasename | --database=databasename ]
[ -H host | --host=host ] [ -P port | --port=port ]
[ -v user | --user=user ] [ -w password | --passwd=password ]
PR

edit-pr is used to make changes to existing PRs in a GNATS database.

edit-pr first examines the PR and locks it if it is not already locked. This is to prevent a PR from being edited by two users simultaneously. If the PR is already in the process of being edited, edit-pr displays the name of the person who owns the lock.

edit-pr then calls $EDITOR on PR. After the PR has been edited, it is resubmitted to the database, and the index is updated.

If you change a field that requires a reason for the change, edit-pr prompts you to supply a reason for the change. A message is then appended to the Audit-Trail field of PR with the changed values and the change reason.

Depending on how the database is configured, editing various fields in the PR may also cause mail to be sent concerning these changes. In the default configuration, any fields that generate Audit-Trail entries will cause a copy of the new Audit-Trail message to be sent.

-h, --help
Prints a brief usage message for edit-pr.
-V, --version
Prints the version number for edit-pr.
-d, --database
Specifies the database containing the PR to be edited; if no database is specified, the database named default is assumed. This option overrides the database specified in the GNATSDB environment variable.

-H, --host
Hostname of the GNATS server.
-P, --port
The port that the GNATS server runs on.
-v, --username
Username used to log into the GNATS server.
-w, --passwd
Password used to log into the GNATS server.

The environment variable EDITOR specifies the editor to invoke on the PR. Default is vi(1).
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.

For network access via gnatsd, it contains a colon-separated list of strings that describe the remote database, in the form

server:port:databasename:username:password

Any of the fields may be omitted, but at least one colon must appear; otherwise, the value is assumed to be the name of a local database.

If GNATSDB is not set, it is assumed that the database is local and that its name is default.

/tmp/ep$$
Temporary file for PR being edited.
/tmp/ed_pr_ch$$
Holds Audit-Trail change message, if needed.
/tmp/u$$
Holds output of lock function.

Keeping Track: Managing Messages With GNATS (also installed 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).

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 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.

August 2003 GNATS

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.