]> git.ipfire.org Git - thirdparty/strongswan.git/blobdiff - doc/manpage.d/ipsec_send-pr.8.html
- import of strongswan-2.7.0
[thirdparty/strongswan.git] / doc / manpage.d / ipsec_send-pr.8.html
diff --git a/doc/manpage.d/ipsec_send-pr.8.html b/doc/manpage.d/ipsec_send-pr.8.html
new file mode 100644 (file)
index 0000000..1902654
--- /dev/null
@@ -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">&nbsp;</A>
+<H2>NAME</H2>
+
+ipsec send-pr - send problem report (PR) to a central support site
+<A NAME="lbAC">&nbsp;</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">&nbsp;</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">&nbsp;</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">&nbsp;</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">&nbsp;</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>&nbsp;for detailed
+information on reporting problems
+<A NAME="lbAH">&nbsp;</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">&nbsp;</A>
+<H2>FILES</H2>
+
+
+
+/tmp/p$$<TT>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TT>copy of PR used in editing session<BR>
+<BR>
+
+/tmp/pf$$<TT>&nbsp;&nbsp;&nbsp;</TT>copy of empty PR form, for testing purposes<BR>
+<BR>
+
+/tmp/pbad$$<TT>&nbsp;</TT>file for rejected PRs<BR>
+<BR>
+
+@IPSEC_DIR@/send-pr.confscript to customize send-pr.<BR>
+<A NAME="lbAJ">&nbsp;</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">&nbsp;</A>
+<H2>INSTALLATION AND CONFIGURATION</H2>
+
+See 
+<B>send-pr.info</B>
+
+or
+<B>INSTALL</B>
+
+for installation instructions.
+<A NAME="lbAL">&nbsp;</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">&nbsp;</A>
+<H2>AUTHORS</H2>
+
+Jeffrey Osier, Brendan Kehoe, Jason Merrill, Heinz G. Seidl (Cygnus
+Support)
+<A NAME="lbAN">&nbsp;</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">&nbsp;</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>