<?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" ?>

<!--
Copyright (C) 2011-2018 Greenbone AG

SPDX-License-Identifier: GPL-2.0-or-later

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 Daemon">

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

  <description>
    <p>
      The Greenbone Security Assistant Daemon (gsad) is a stand-alone web server
      that acts as the layer between the front-end application Greenbone
      Security Assistant (GSA) and the central Greenbone Vulnerability Manager Daemon
      (gvmd).
    </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>--user-session-limit=<arg>MAX_SESSIONS</arg></opt></p>
      <optdesc>
        <p>Set maximum number of active sessions per user. 0 for unlimited.</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="openvas" section="8"/>
      <manref name="gvmd" section="8"/>
      <manref name="ospd-openvas" section="8"/>
    </p>
  </section>

  <section name="MORE INFORMATION">
    <p>
      The canonical places where you will find more information
      about the Greenbone Vulnerability Manager are:

      <url href="https://community.greenbone.net"/>
      (Community Portal)

      <url href="https://github.com/greenbone"/>
      (Development Platform)

      <url href="https://www.greenbone.net"/>
      (Greenbone Website)
    </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>
