Intial skeleton gssproxy daemon

3 files changed, 321 insertions, 0 deletions

diff --git a/proxy/man/Makefile.am b/proxy/man/Makefile.am
new file mode 100644
index 0000000..bbffd01
--- /dev/null
+++ b/proxy/man/Makefile.am
@@ -0,0 +1,164 @@
+# The following variable is dependent on placement of this file
+top_builddir = ..
+
+############
+# MANPAGES #
+############
+
+#Special Rules:
+export SGML_CATALOG_FILES
+DOCBOOK_XSLT = http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
+XMLLINT_FLAGS = --catalogs --postvalid --nonet --xinclude --noout
+XSLTPROC_FLAGS = --catalogs --xinclude --nonet
+
+man_MANS = \
+    gssproxy.8 gssproxy.conf.5
+
+EXTRA_DIST = $(man_MANS:%=%.xml) $(wildcard $(srcdir)/include/*.xml)
+
+SUFFIXES = .1.xml .1 .3.xml .3 .5.xml .5 .8.xml .8
+.1.xml.1:
+	$(XMLLINT) $(XMLLINT_FLAGS) $<
+	$(XSLTPROC) -o $@  $(XSLTPROC_FLAGS) $(DOCBOOK_XSLT) $<
+
+.3.xml.3:
+	$(XMLLINT) $(XMLLINT_FLAGS) $<
+	$(XSLTPROC) -o $@  $(XSLTPROC_FLAGS) $(DOCBOOK_XSLT) $<
+
+.5.xml.5:
+	$(XMLLINT) $(XMLLINT_FLAGS) $<
+	$(XSLTPROC) -o $@  $(XSLTPROC_FLAGS) $(DOCBOOK_XSLT) $<
+
+.8.xml.8:
+	$(XMLLINT) $(XMLLINT_FLAGS) $<
+	$(XSLTPROC) -o $@  $(XSLTPROC_FLAGS) $(DOCBOOK_XSLT) $<
+
+########################
+# MANPAGE TRANSLATIONS #
+########################
+
+PO4A=@PO4A@
+SED=@SED@
+
+PACKAGE_DOC=gssproxy-docs
+
+POTFILE = po/$(PACKAGE_DOC).pot
+PO4A_CONFIG = po/po4a.cfg
+
+# Extract the list of languages from the po4a config file.
+LINGUAS_DIST = `$(SED) -ne 's/^.*\[po4a_langs\] \(.*\)$$/\1/p' $(srcdir)/$(PO4A_CONFIG)`
+
+# If the user has not defined it let's use the default.
+LINGUAS ?= $(LINGUAS_DIST)
+
+PO4A_COMMON_OPTS = --option doctype=docbook \
+		   --package-name $(PACKAGE_DOC) \
+		   --variable builddir=$(CURDIR) \
+		   --package-version $(PACKAGE_VERSION) \
+		   --msgid-bugs-address simo@redhat.com \
+		   --copyright-holder "Red Hat"
+
+PO4A_BUILD_OPTS = $(PO4A_COMMON_OPTS) --no-backups
+
+EXTRA_DIST += \
+	$(POTFILE)\
+	$(PO4A_CONFIG)
+
+XML_DOC = $(wildcard $(srcdir)/*.xml) $(wildcard $(srcdir)/include/*.xml)
+
+if HAVE_PO4A
+
+# FIXME: Use a stamp file until po4a supports them internally.
+man.stamp: $(XML_DOC) $(POTFILE) $(PO4A_CONFIG)
+	cd $(srcdir) && \
+	$(PO4A) $(PO4A_BUILD_OPTS) $(PO4A_CONFIG)
+	touch $@
+
+update-po:
+	cd $(srcdir) && \
+	$(PO4A) $(PO4A_BUILD_OPTS) --force $(PO4A_CONFIG)
+
+dist-hook: man.stamp
+	if [ -f man.stamp ]; then \
+		cp man.stamp $(distdir); \
+		for lang in $(LINGUAS_DIST); do \
+			cp $(srcdir)/po/$$lang.po $(distdir)/po; \
+			$(mkdir_p) $(distdir)/$$lang; \
+			cp -r $(builddir)/$$lang $(distdir)/; \
+		done; \
+	else \
+		cp $(srcdir)/man.stamp $(distdir); \
+		for lang in $(LINGUAS_DIST); do \
+			cp $(srcdir)/po/$$lang.po $(distdir)/po; \
+			$(mkdir_p) $(distdir)/$$lang; \
+			cp -r $(srcdir)/$$lang $(distdir)/; \
+		done; \
+	fi
+
+
+clean-local-no:
+clean-local-yes:
+	for lang in $(LINGUAS); do \
+		if [ -d $$lang ]; then \
+			rm -rf $$lang; \
+		fi \
+	done
+	rm -f $(man_MANS)
+	rm -f man.stamp
+
+else
+
+man.stamp: $(XML_DOC)
+	touch $@
+
+clean-local-no:
+clean-local-yes:
+	rm -f $(man_MANS)
+	rm -f man.stamp
+
+endif
+
+clean-local: clean-local-@USE_NLS@
+distclean-local: clean-local-@USE_NLS@
+mostlyclean-local: clean-local-@USE_NLS@
+maintainer-clean-local: clean-local-@USE_NLS@
+
+# Generate translated manual pages
+all-local: all-local-@USE_NLS@
+all-local-no:
+all-local-yes: man.stamp
+	if [ -z $$recursion ]; then \
+		for lang in $(LINGUAS); do \
+			if [ -d $$lang ]; then \
+				sources=$$(ls -1 $$lang/*.xml); \
+				manpages=$$(echo $$sources | $(SED) 's/\.xml//g'); \
+				$(MAKE) recursion=1 man_MANS="$$manpages"; \
+			fi \
+		done \
+	fi
+
+install-data-local: install-data-local-@USE_NLS@
+install-data-local-no:
+install-data-local-yes:
+	for lang in $(LINGUAS); do \
+		if [ -d $$lang ]; then \
+			sources=$$(ls -1 $$lang/*.xml); \
+			manpages=$$(echo $$sources | $(SED) 's/\.xml//g'); \
+			$(MAKE) install-man \
+				mandir="$(mandir)/$$lang" \
+				man_MANS="$$manpages"; \
+		fi \
+	done
+
+uninstall-local: uninstall-local-@USE_NLS@
+uninstall-local-no:
+uninstall-local-yes:
+	for lang in $(LINGUAS); do \
+		if [ -d $$lang ]; then \
+			sources=$$(ls -1 $$lang/*.xml); \
+			manpages=$$(echo $$sources | $(SED) 's/\.xml//g'); \
+			$(MAKE) uninstall-man \
+				mandir="$(mandir)/$$lang" \
+				man_MANS="$$manpages"; \
+		fi \
+	done
diff --git a/proxy/man/gssproxy.8.xml b/proxy/man/gssproxy.8.xml
new file mode 100644
index 0000000..d2c374c
--- /dev/null
+++ b/proxy/man/gssproxy.8.xml
@@ -0,0 +1,127 @@
+<?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 daemons to manage access to
+            GSSAPI credetnials.
+        </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 non-default config file. The default is
+                        <filename>/etc/gssprosy/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>--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>
+                        Tells the GssProxy to stop writing to its current debug
+                        file descriptors and to close and reopen them. This is
+                        meant to facilitate log rolling with programs like
+                        logrotate.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsect1>
+
+    <refsect1 id='see_also'>
+        <title>SEE ALSO</title>
+        <para>
+            <citerefentry>
+                <refentrytitle>gssproxy.conf</refentrytitle><manvolnum>5</manvolnum>
+            </citerefentry>.
+        </para>
+    </refsect1>
+</refentry>
+</reference>
diff --git a/proxy/man/gssproxy.conf.5.xml b/proxy/man/gssproxy.conf.5.xml
new file mode 100644
index 0000000..9b1dc7a
--- /dev/null
+++ b/proxy/man/gssproxy.conf.5.xml
@@ -0,0 +1,30 @@
+<?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.conf</refentrytitle>
+        <manvolnum>5</manvolnum>
+    </refmeta>
+
+    <refnamediv id='name'>
+        <refname>gssproxy.conf</refname>
+        <refpurpose>GssProxy Daemon Configuration file</refpurpose>
+    </refnamediv>
+
+    <refsect1 id='description'>
+        <title>DESCRIPTION</title>
+        <para>
+            Optional configuration directives for the gssproxy daemon.
+        </para>
+    </refsect1>
+
+</refentry>
+</reference>