<?xml version="1.0" standalone='no'?>
<!DOCTYPE manpage SYSTEM "/usr/share/xmltoman/xmltoman.dtd">
<?xml-stylesheet type="text/xsl" href="/usr/share/xmltoman/xmltoman.xsl" ?>

<!-- OpenVAS
 $Id$
 Description: gsad manpage

 Authors:
 Matthew Mundell <matthew.mundell@greenbone.net>
 Michael Wiegand <michael.wiegand@greenbone.net>

 Copyright:
 Copyright (C) 2011 Greenbone Networks GmbH

 This program is free software; you can redistribute it and/or
 modify it under the terms of the GNU General Public License
 as published by the Free Software Foundation; either version 2
 of the License, or (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-->

<manpage name="gsad" section="8" desc="Greenbone Security Assistant for the Open Vulnerability Assessment System (OpenVAS)">

  <synopsis>
    <cmd>gsad OPTIONS</cmd>
  </synopsis>

  <description>
    <p>
      Together, OpenVAS Scanner (openvassd(8)) and OpenVAS Manager
      (openvasmd(8)) provide the core functionality of the Open
      Vulnerability Assessment System (OpenVAS), with OpenVAS Scanner
      handling the actual scan process and OpenVAS Manager adding
      various management functionalities to handle and organise scan
      results.
    </p>

    <p>
      The Greenbone Security Assistant Daemon (gsad) is a web
      application that connects to the OpenVAS Manager to provide for a
      full-featured user interface for vulnerability management.
    </p>

  </description>

  <options>
    <option>
      <p><opt>-f, --foreground</opt></p>
      <optdesc><p>Run in foreground.</p></optdesc>
    </option>

    <option>
      <p><opt>--http-only</opt></p>
      <optdesc><p>Serve HTTP only, without SSL.</p></optdesc>
    </option>

    <option>
      <p><opt>--listen=<arg>ADDRESS</arg></opt></p>
      <optdesc><p>Listen on ADDRESS.</p></optdesc>
    </option>

    <option>
      <p><opt>--mlisten=<arg>ADDRESS</arg></opt></p>
      <optdesc><p>Manager address.</p></optdesc>
    </option>

    <option>
      <p><opt>-p, --port=<arg>PORT</arg></opt></p>
      <optdesc><p>Listen on port number PORT.</p></optdesc>
    </option>

    <option>
      <p><opt>-m, --mport=<arg>PORT</arg></opt></p>
      <optdesc><p>Use manager port number PORT.</p></optdesc>
    </option>

    <option>
      <p><opt>-r, --rport=<arg>PORT</arg></opt></p>
      <optdesc><p>Redirect HTTP from port number PORT.</p></optdesc>
    </option>

    <option>
      <p><opt>-R, --redirect</opt></p>
      <optdesc><p>Redirect HTTP to HTTPS.</p></optdesc>
    </option>

    <option>
      <p><opt>-k, --ssl-private-key=<arg>FILE</arg></opt></p>
      <optdesc><p>Use FILE as the private key for HTTPS</p></optdesc>
    </option>

    <option>
      <p><opt>-c, --ssl-certificate=<arg>FILE</arg></opt></p>
      <optdesc><p>Use FILE as the certificate for HTTPS</p></optdesc>
    </option>

    <option>
      <p><opt>--do-chroot</opt></p>
      <optdesc><p>Do chroot and drop privileges.</p></optdesc>
    </option>

    <option>
      <p><opt>-v, --verbose</opt></p>
      <optdesc>
        <p>Print progress messages.</p>
      </optdesc>
    </option>

    <option>
      <p><opt>-V, --version</opt></p>
      <optdesc>
        <p>Print version.</p>
      </optdesc>
    </option>

    <option>
      <p><opt>-?, --help</opt></p>
      <optdesc>
        <p>Show help.</p>
      </optdesc>
    </option>
  </options>

  <section name="EXAMPLES">
    <p>gsad</p>
    <p>
      Start gsad with the default port configuration and listen on
      port 443 for HTTPS requests.
    </p>
  </section>

  <section name="SEE ALSO">
    <p>
      <manref name="openvassd" section="8"/>
      <manref name="openvasad" section="8"/>
      <manref name="omp" section="8"/>
      <manref name="openvasmd" section="8"/>
      <manref name="gsd" section="8"/>
    </p>
  </section>

  <section name="MORE INFORMATION ABOUT THE OpenVAS PROJECT">
    <p>
      The canonical places where you will find more information
      about the OpenVAS project are:

      <url href="http://www.openvas.org/"/>
      (Official site)

      <url href="http://wald.intevation.org/projects/openvas/"/>
      (Development Platform)
    </p>
  </section>

  <section name="COPYRIGHT">
    <p>
      The Greenbone Security Assistant is released under the GNU GPL,
      version 2, or, at your option, any later version.
    </p>
  </section>

</manpage>
