<refentry id="goa-daemon.8">
  <refentryinfo>
    <title>goa-daemon</title>
    <date>June 2020</date>
    <productname>GNOME</productname>
  </refentryinfo>

  <refmeta>
    <refentrytitle>goa-daemon</refentrytitle>
    <manvolnum>8</manvolnum>
    <refmiscinfo class="manual">System Management Commands</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>goa-daemon</refname>
    <refpurpose>GNOME Online Accounts Daemon</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>goa-daemon</command>
      <arg><option>--help</option></arg>
      <arg><option>--replace</option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>


  <refsect1>
    <title>DESCRIPTION</title>
    <para>
      The <command>goa-daemon</command> program provides the
      <emphasis>org.gnome.OnlineAccounts</emphasis> name on the
      session message bus. Users or administrators should never need
      to start this daemon as it will be automatically started by
      <citerefentry><refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum></citerefentry>
      whenever an application sends a D-Bus message to the
      <emphasis>org.gnome.OnlineAccounts</emphasis> name on the
      session bus.
    </para>
  </refsect1>

  <refsect1>
    <title>CONFIGURATION FILE</title>
    <para>
      The <command>goa-daemon</command> program stores configuration
      in the
      <filename>$XDG_CONFIG_HOME/goa-1.0/accounts.conf</filename>
      (typically
      <filename>~/.config/goa-1.0/accounts.conf</filename>)
      file. The format of this file is private and 3rd party programs
      or libraries should never read it. This file does not contain
      any passwords or secrets.
    </para>
    <para>
     See the <ulink
     url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG
     Base Directory Specification</ulink> for more information about
     <literal>$XDG_CONFIG_HOME</literal>.
    </para>
  </refsect1>

  <refsect1>
    <title>SECRETS</title>
    <para>
      The <command>goa-daemon</command> program stores secrets (such as
      OAuth tokens) in
      <ulink url="https://wiki.gnome.org/Projects/GnomeKeyring">GNOME Keyring</ulink>.
      The format of the stored secrets is private and 3rd party
      programs or libraries should never read, modify or delete these secrets.
    </para>
  </refsect1>

  <refsect1>
    <title>OPTIONS</title>
    <variablelist>
      <varlistentry>
        <term><option>--replace</option></term>
        <listitem>
          <para>
            Replace existing instance.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--help</option></term>
        <listitem>
          <para>
            Show help options.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1><title>AUTHOR</title>
    <para>
      Written by David Zeuthen <email><![CDATA[zeuthen@gmail.com]]></email> with
      a lot of help from many others.
    </para>
  </refsect1>

  <refsect1>
    <title>BUGS</title>
    <para>
      Please send bug reports to either the distribution bug tracker
      or the upstream bug tracker at
      <ulink url="https://gitlab.gnome.org/GNOME/gnome-online-accounts/issues"></ulink>.
      There are some debugging tips at
      <ulink url="https://wiki.gnome.org/Projects/GnomeOnlineAccounts/Debugging"></ulink>
    </para>
  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>
    <para>
      <citerefentry>
        <refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum>
      </citerefentry>
    </para>
  </refsect1>
</refentry>
