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

<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>--api-only</opt></p>
      <optdesc>
        <p>Run in API-only mode, disabling serving of static content.</p>
      </optdesc>
    </option>

    <option>
      <p><opt>--jwt-requested</opt></p>
      <optdesc>
        <p>Enable JWT-based mode using the token returned in the login response.</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 Daemon is released under the GNU GPL,
      version 2, or, at your option, any later version.
    </p>
  </section>

</manpage>
