428 lines
9.0 KiB
HTML
428 lines
9.0 KiB
HTML
Content-type: text/html
|
|
|
|
<HTML><HEAD><TITLE>Manpage of SEND-PR</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>SEND-PR</H1>
|
|
Section: User Commands (1)<BR>Updated: xVERSIONx<BR><A HREF="#index">Index</A>
|
|
<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
ipsec send-pr - send problem report (PR) to a central support site
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>ipsec send-pr</B>
|
|
|
|
[
|
|
<I>site</I>
|
|
|
|
]
|
|
[
|
|
<B>-f</B>
|
|
|
|
<I>problem-report</I>
|
|
|
|
]
|
|
[
|
|
<B>-t</B>
|
|
|
|
<I>mail-address</I>
|
|
|
|
]
|
|
<BR>
|
|
|
|
|
|
[
|
|
<B>-P</B>
|
|
|
|
]
|
|
[
|
|
<B>-L</B>
|
|
|
|
]
|
|
[
|
|
<B>-s</B>
|
|
|
|
<I>severity</I>
|
|
|
|
]
|
|
[
|
|
<B>-c</B>
|
|
|
|
<I>address</I>
|
|
|
|
]
|
|
<BR>
|
|
|
|
[
|
|
<B>--request-id</B>
|
|
|
|
]
|
|
[
|
|
<B>-V</B>
|
|
|
|
]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>ipsec send-pr</B>
|
|
|
|
is a tool used to submit
|
|
<I>problem reports </I>
|
|
|
|
|
|
(PRs) to a central support site. In most cases the correct
|
|
<I>site</I>
|
|
|
|
will be the default. This argument indicates the support site which
|
|
is responsible for the category of problem involved. Some sites may
|
|
use a local address as a default.
|
|
<I>site</I>
|
|
|
|
values are defined by using the
|
|
<B><A HREF="aliases.5.html">aliases</A></B>(5).
|
|
|
|
<P>
|
|
|
|
<B>ipsec send-pr</B>
|
|
|
|
invokes an editor on a problem report template (after trying to fill
|
|
in some fields with reasonable default values). When you exit the
|
|
editor,
|
|
<B>ipsec send-pr </B>
|
|
|
|
sends the completed form to the
|
|
<I>Problem Report Management System</I>
|
|
|
|
(<B>GNATS</B>) at a central support site. At the support site, the PR
|
|
is assigned a unique number and is stored in the <B>GNATS</B> database
|
|
according to its category and submitter-id. <B>GNATS</B> automatically
|
|
replies with an acknowledgement, citing the category and the PR
|
|
number.
|
|
<P>
|
|
|
|
To ensure that a PR is handled promptly, it should contain your (unique)
|
|
<I>submitter-id</I> and one of the available <I>categories</I> to identify the
|
|
problem area. (Use
|
|
<B>`ipsec send-pr -L'</B>
|
|
|
|
to see a list of categories.)
|
|
<P>
|
|
|
|
The
|
|
<B>ipsec send-pr</B>
|
|
|
|
template at your site should already be customized with your
|
|
submitter-id (running `<B>install-sid</B> <I>submitter-id</I>' to
|
|
accomplish this is part of the installation procedures for
|
|
<B>ipsec</B>send-pr<B>).</B>
|
|
|
|
If this hasn't been done, see your system administrator for your
|
|
submitter-id, or request one from your support site by invoking
|
|
<B>`ipsec send-pr --request-id'.</B>
|
|
|
|
If your site does not distinguish between different user sites, or if
|
|
you are not affiliated with the support site, use
|
|
<B>`net'</B>
|
|
|
|
for this field.
|
|
<P>
|
|
|
|
The more precise your problem description and the more complete your
|
|
information, the faster your support team can solve your problems.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT><B>-f</B><I> problem-report</I>
|
|
|
|
<DD>
|
|
specify a file (<I>problem-report</I>) which already contains a
|
|
complete problem report.
|
|
<B>ipsec send-pr</B>
|
|
|
|
sends the contents of the file without invoking the editor. If
|
|
the value for
|
|
<I>problem-report</I>
|
|
|
|
is
|
|
<B>`-'</B>,
|
|
|
|
then
|
|
<B>ipsec send-pr</B>
|
|
|
|
reads from standard input.
|
|
<DT><B>-s</B><I> severity</I>
|
|
|
|
<DD>
|
|
Give the problem report the severity
|
|
<I>severity</I>.
|
|
|
|
<DT><B>-t</B><I> mail-address</I>
|
|
|
|
<DD>
|
|
Change mail address at the support site for problem reports. The
|
|
default
|
|
<I>mail-address</I>
|
|
|
|
is the address used for the default
|
|
<I>site</I>.
|
|
|
|
Use the
|
|
<I>site</I>
|
|
|
|
argument rather than this option in nearly all cases.
|
|
<DT><B>-c</B><I> address</I>
|
|
|
|
<DD>
|
|
Put
|
|
<I>address</I>
|
|
|
|
in the
|
|
<B>Cc:</B>
|
|
|
|
header of the message.
|
|
<DT><B>-P</B>
|
|
|
|
<DD>
|
|
print the form specified by the environment variable
|
|
<B>PR_FORM </B>
|
|
|
|
on standard output. If
|
|
<B>PR_FORM</B>
|
|
|
|
is not set, print the standard blank PR template. No mail is sent.
|
|
<DT><B>-L</B>
|
|
|
|
<DD>
|
|
print the list of available categories. No mail is sent.
|
|
<DT><B>--request-id</B>
|
|
|
|
<DD>
|
|
sends mail to the default support site, or
|
|
<I>site</I>
|
|
|
|
if specified, with a request for your
|
|
<I>submitter-id</I>.
|
|
|
|
If you are
|
|
not affiliated with
|
|
<I>site</I>,
|
|
|
|
use a
|
|
<I>submitter-id</I>
|
|
|
|
of
|
|
<B>net</B>'.
|
|
|
|
<DT><B>-V</B>
|
|
|
|
<DD>
|
|
Display the
|
|
<B>ipsec send-pr</B>
|
|
|
|
version number.
|
|
</DL>
|
|
<P>
|
|
|
|
Note: use
|
|
<B>ipsec send-pr</B>
|
|
|
|
to submit problem reports rather than mailing them directly. Using
|
|
both the template and
|
|
<B>ipsec send-pr</B>
|
|
|
|
itself will help ensure all necessary information will reach the
|
|
support site.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
The environment variable
|
|
<B>EDITOR</B>
|
|
|
|
specifies the editor to invoke on the template.
|
|
<BR>
|
|
|
|
default:
|
|
<B>vi</B>
|
|
|
|
<P>
|
|
If the environment variable
|
|
<B>PR_FORM</B>
|
|
|
|
is set, then its value is used as the file name of the template for
|
|
your problem-report editing session. You can use this to start with a
|
|
partially completed form (for example, a form with the identification
|
|
fields already completed).
|
|
<A NAME="lbAG"> </A>
|
|
<H2>HOW TO FILL OUT A PROBLEM REPORT</H2>
|
|
|
|
Problem reports have to be in a particular form so that a program can
|
|
easily manage them. Please remember the following guidelines:
|
|
<DL COMPACT>
|
|
<DT>*<DD>
|
|
describe only
|
|
<B>one problem</B>
|
|
|
|
with each problem report.
|
|
<DT>*<DD>
|
|
For follow-up mail, use the same subject line as the one in the automatic
|
|
acknowledgent. It consists of category, PR number and the original synopsis
|
|
line. This allows the support site to relate several mail messages to a
|
|
particular PR and to record them automatically.
|
|
<DT>*<DD>
|
|
Please try to be as accurate as possible in the subject and/or synopsis line.
|
|
<DT>*<DD>
|
|
The subject and the synopsis line are not confidential. This is
|
|
because open-bugs lists are compiled from them. Avoid confidential
|
|
information there.
|
|
</DL>
|
|
<P>
|
|
|
|
See the GNU
|
|
<B>Info </B>
|
|
|
|
file
|
|
<B>send-pr.info</B>
|
|
|
|
or the document <I>Reporting Problems With send-pr</I> for detailed
|
|
information on reporting problems
|
|
<A NAME="lbAH"> </A>
|
|
<H2>HOW TO SUBMIT TEST CASES, CODE, ETC.</H2>
|
|
|
|
Submit small code samples with the PR. Contact the support site for
|
|
instructions on submitting larger test cases and problematic source
|
|
code.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
|
|
|
|
/tmp/p$$<TT> </TT>copy of PR used in editing session<BR>
|
|
<BR>
|
|
|
|
/tmp/pf$$<TT> </TT>copy of empty PR form, for testing purposes<BR>
|
|
<BR>
|
|
|
|
/tmp/pbad$$<TT> </TT>file for rejected PRs<BR>
|
|
<BR>
|
|
|
|
@IPSEC_DIR@/send-pr.confscript to customize send-pr.<BR>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>EMACS USER INTERFACE</H2>
|
|
|
|
An Emacs user interface for
|
|
<B>send-pr</B>
|
|
|
|
with completion of field values is part of the
|
|
<B>send-pr</B>
|
|
|
|
distribution (invoked with
|
|
<B>M-x send-pr</B>).
|
|
|
|
See the file
|
|
<B>send-pr.info</B>
|
|
|
|
or the ASCII file
|
|
<B>INSTALL</B>
|
|
|
|
in the top level directory of the distribution for configuration and
|
|
installation information. The Emacs LISP template file is
|
|
<B>send-pr-el.in</B>
|
|
|
|
and is installed as
|
|
<B>send-pr.el</B>.
|
|
|
|
<A NAME="lbAK"> </A>
|
|
<H2>INSTALLATION AND CONFIGURATION</H2>
|
|
|
|
See
|
|
<B>send-pr.info</B>
|
|
|
|
or
|
|
<B>INSTALL</B>
|
|
|
|
for installation instructions.
|
|
<A NAME="lbAL"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<I>Reporting Problems Using send-pr</I>
|
|
|
|
(also installed as the GNU Info file
|
|
<B>send-pr.info</B>).
|
|
|
|
<P>
|
|
|
|
<B><A HREF="http://localhost/cgi-bin/man/man2html?l+gnats">gnats</A></B>(l),
|
|
|
|
<B><A HREF="query-pr.1.html">query-pr</A></B>(1),
|
|
|
|
<B><A HREF="edit-pr.1.html">edit-pr</A></B>(1),
|
|
|
|
<B><A HREF="gnats.8.html">gnats</A></B>(8),
|
|
|
|
<B><A HREF="queue-pr.8.html">queue-pr</A></B>(8),
|
|
|
|
<B><A HREF="at-pr.8.html">at-pr</A></B>(8),
|
|
|
|
<B><A HREF="mkcat.8.html">mkcat</A></B>(8),
|
|
|
|
<B><A HREF="mkdist.8.html">mkdist</A></B>(8).
|
|
|
|
<A NAME="lbAM"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Jeffrey Osier, Brendan Kehoe, Jason Merrill, Heinz G. Seidl (Cygnus
|
|
Support)
|
|
<A NAME="lbAN"> </A>
|
|
<H2>COPYING</H2>
|
|
|
|
Copyright (c) 1992, 1993 Free Software Foundation, Inc.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT><A HREF="#lbAB">NAME</A><DD>
|
|
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT><A HREF="#lbAF">ENVIRONMENT</A><DD>
|
|
<DT><A HREF="#lbAG">HOW TO FILL OUT A PROBLEM REPORT</A><DD>
|
|
<DT><A HREF="#lbAH">HOW TO SUBMIT TEST CASES, CODE, ETC.</A><DD>
|
|
<DT><A HREF="#lbAI">FILES</A><DD>
|
|
<DT><A HREF="#lbAJ">EMACS USER INTERFACE</A><DD>
|
|
<DT><A HREF="#lbAK">INSTALLATION AND CONFIGURATION</A><DD>
|
|
<DT><A HREF="#lbAL">SEE ALSO</A><DD>
|
|
<DT><A HREF="#lbAM">AUTHORS</A><DD>
|
|
<DT><A HREF="#lbAN">COPYING</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 21:40:18 GMT, November 11, 2003
|
|
</BODY>
|
|
</HTML>
|