- import of strongswan-2.7.0
- applied patch for charon
This commit is contained in:
Martin Willi
@@ -0,0 +1,427 @@
|
||||
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>
|
||||
Reference in New Issue
Block a user