<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<reference>
<title>GssProxy Manual pages</title>
<refentry>
<refentryinfo>
<productname>GSS Proxy</productname>
<orgname>GSS-Proxy - http://fedorahosted.org/gss-proxy</orgname>
</refentryinfo>
<refmeta>
<refentrytitle>gssproxy</refentrytitle>
<manvolnum>8</manvolnum>
</refmeta>
<refnamediv id='name'>
<refname>gssproxy</refname>
<refpurpose>GssProxy Daemon</refpurpose>
</refnamediv>
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
<command>gssproxy</command>
<arg choice='opt'>
<replaceable>options</replaceable>
</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id='description'>
<title>DESCRIPTION</title>
<para>
<command>gssproxy</command> provides a daemon to manage access to
GSSAPI credentials.
</para>
<para>
<command>gssproxy</command> consists of the <command>gssproxy</command> daemon
(configured by the <citerefentry><refentrytitle>gssproxy.conf</refentrytitle>
<manvolnum>5</manvolnum></citerefentry> file) and a GSSAPI interposer plugin
(<citerefentry><refentrytitle>gssproxy-mech</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>).
</para>
</refsect1>
<refsect1 id='options'>
<title>OPTIONS</title>
<variablelist remap='IP'>
<varlistentry>
<term>
<option>-D</option>,<option>--daemon</option>
</term>
<listitem>
<para>
Become a daemon after starting up.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-i</option>,<option>--interactive</option>
</term>
<listitem>
<para>
Run in the foreground, don't become a daemon.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-c</option>,<option>--config</option>
</term>
<listitem>
<para>
Specify a config file to use as the main config file
(read before the rest of the config directory). The
default is to use the file
<filename>/etc/gssproxy/gssproxy.conf</filename>.
For reference on the config file syntax and options,
consult the
<citerefentry>
<refentrytitle>gssproxy.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry>
manual page.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-C</option>,<option>--configdir</option>
</term>
<listitem>
<para>
Specify a non-default config dir. Files named of the
form "##-foo.conf" (that is, beginning with two digits
and a dash, and ending in ".conf") will be read in
numeric order from this directory, in addition to the
config file itself. The default is
<filename>/etc/gssproxy</filename>. For reference on
the config file syntax and options, consult the
<citerefentry>
<refentrytitle>gssproxy.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry>
manual page.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-s</option>,<option>--socket</option>
</term>
<listitem>
<para>
Specify a custom default socket name. This socket will be used
by all sections that do not define an explicit socket.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-d</option>,<option>--debug</option>
</term>
<listitem>
<para>
Turn on debugging.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>--version</option>
</term>
<listitem>
<para>
Print version number and exit.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>Signals</title>
<variablelist remap='IP'>
<varlistentry>
<term>SIGTERM/SIGINT</term>
<listitem>
<para>
Informs the GssProxy to gracefully terminate all of its
child processes and then shut down.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>SIGHUP</term>
<listitem>
<para>
Request a reload of all configuration for gssproxy.
If there is an error in the configuration files, the
existing configuration will not be replaced; if there
is a problem applying the new configuration, gssproxy
will exit.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id='see_also'>
<title>SEE ALSO</title>
<para>
<citerefentry>
<refentrytitle>gssproxy.conf</refentrytitle><manvolnum>5</manvolnum>
</citerefentry> and
<citerefentry>
<refentrytitle>gssproxy-mech</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>.
</para>
</refsect1>
</refentry>
</reference>