<!doctype refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
  <!ENTITY dhfirstname "<firstname>Christian</firstname>">
  <!ENTITY dhsurname   "<surname>Bayle</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>may 14, 2001</date>">
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
       allowed: see man(7), man(1). -->
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>bayle@aist.enst.fr</email>">
  <!ENTITY dhusername  "Christian Bayle">
  <!ENTITY dhucpackage "<refentrytitle>@FORGENAME@</refentrytitle>">
  <!ENTITY dhpackage   "cvssh">

  <!ENTITY debian      "<productname>Debian GNU/Linux</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
]>

<refentry>
  <docinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
    <copyright>
      <year>2000</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </docinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&dhpackage;</refname>

    <refpurpose>CVS shell for @FORGENAME@ / General execution wRAPper LITE!
    </refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&dhpackage;</command>

      <arg><option>-e <replaceable>"foo"</replaceable></option></arg>
      <arg><option>-e <replaceable>"foo bar"</replaceable></option></arg>
      <arg><option>-e <replaceable>"foo -c foo -f bar"</replaceable></option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

    <para>This manual page documents briefly the
      <command>&dhpackage;</command> command.</para>

    <para>This manual page was written for the &debian; distribution
      because the original program does not have a manual page, but 
      a documentation in the code.
    </para>

    <para><command>&dhpackage;</command> formely called grap or graplite is a
    wrapper designed to verify commands before passing them to system()
    or just reporting the accepted command.  cvssh will report an error if the
    input is invalid.  It checks for string lengths (prevent overflows),
    specific sets of options and commands.
    </para>

  </refsect1>
  <refsect1>
    <title>OPTIONS</title>

    <para>
    These programs follow the usual GNU command line syntax,
      with long options starting with two dashes (`-').  A summary of
      options is included below. 

    cvssh, in full force, is called as: &lt;cvssh&gt; &lt;option&gt;
    "&lt;command&gt; &lt;arguments list ... &gt;" where &lt;cvssh&gt;
    is this program, &lt;option&gt; is an optional trap for a single
    option (like "-e" or "-c" used by programs that call shells,
    subject to the approval list below), &lt;command&gt; is the
    command wished to be run (subject to the approval list below), and
    &lt;arguments list .. &gt; is the list of args passed to
    &lt;command&gt; All are optional, allowing for forms such as:
    cvssh -e "foo" cvssh "foo bar" cvssh -e "foo -c foo -f bar" &lt;g
    &gt;&lt;o &gt;&lt;cmd&gt; &lt;g &gt; &lt;cmd/args&gt; &lt;g
    &gt;&lt;o&gt; &lt;cmd/ args &gt;
    
    &lt;options&gt; and &lt;command&gt; need to be exact matched to those in the
    acceptance list.
    </para>

    <variablelist>
      <varlistentry>
        <term><option>-e</option>
        </term>
        <listitem>
          <para>Accepted commands.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>SEE ALSO</title>

    <para>@FORGENAME@ package documentation.</para>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>

    <para>This manual page was written by &dhusername; &dhemail; for
      the &debian; system (but may be used by others). Original 
      comment in the code is Copyrighted (C) 1999 Lion Templin
      lion@leonine.com </para>

    <!-- <para>Permission is granted to copy, distribute and/or modify
      this document under the terms of the <acronym>GNU</acronym> Free
      Documentation License, Version 1.1 or any later version
      published by the Free Software Foundation; with no Invariant
      Sections, no Front-Cover Texts and no Back-Cover Texts.  A copy
      of the license can be found under
      <filename>/usr/share/common-licenses/FDL</filename>.</para> -->

  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
