diff options
Diffstat (limited to 'doc/manpage.d/ipsec_send-pr.8.html')
| -rw-r--r-- | doc/manpage.d/ipsec_send-pr.8.html | 427 |
1 files changed, 427 insertions, 0 deletions
diff --git a/doc/manpage.d/ipsec_send-pr.8.html b/doc/manpage.d/ipsec_send-pr.8.html new file mode 100644 index 000000000..19026543a --- /dev/null +++ b/doc/manpage.d/ipsec_send-pr.8.html @@ -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> |