From 08173993ff56ff8552575dc1ef321f30e33d900c Mon Sep 17 00:00:00 2001 From: Günther Deschner Date: Thu, 17 Oct 2013 17:17:24 +0200 Subject: docs: autogenerate proxymech manpage. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Günther Deschner --- proxy/configure.ac | 3 +- proxy/man/gssproxy-mech.8.xml | 133 --------------------------------------- proxy/man/gssproxy-mech.8.xml.in | 133 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 135 insertions(+), 134 deletions(-) delete mode 100644 proxy/man/gssproxy-mech.8.xml create mode 100644 proxy/man/gssproxy-mech.8.xml.in diff --git a/proxy/configure.ac b/proxy/configure.ac index f3269e3..b75a1ef 100644 --- a/proxy/configure.ac +++ b/proxy/configure.ac @@ -180,5 +180,6 @@ AC_DEFINE_UNQUOTED([ABS_BUILD_DIR], ["$abs_build_dir"], [Absolute path to the bu AC_SUBST([abs_builddir], $abs_build_dir) AC_CONFIG_FILES([Makefile systemd/gssproxy.service man/Makefile - contrib/gssproxy.spec examples/mech examples/gssproxy.conf]) + contrib/gssproxy.spec examples/mech examples/gssproxy.conf + man/gssproxy-mech.8.xml]) AC_OUTPUT diff --git a/proxy/man/gssproxy-mech.8.xml b/proxy/man/gssproxy-mech.8.xml deleted file mode 100644 index b2d008c..0000000 --- a/proxy/man/gssproxy-mech.8.xml +++ /dev/null @@ -1,133 +0,0 @@ - - - -GssProxy GSSAPI mechanism manual page - - - GSS Proxy - GSS-Proxy - http://fedorahosted.org/gss-proxy - - - - gssproxy-mech - 8 - - - - gssproxy-mech - GssProxy GSSAPI mechanism plugin - - - - - proxymech_v1 2.16.840.1.113730.3.8.15.1 /usr/lib64/gssproxy/proxymech.so - - options - - - - - - DESCRIPTION - - The gssproxy proxymech module is a interposer plugin that is - loaded by GSSAPI. It is enabled by - /etc/gss/mech configuration file. - - - The interposer plugin allows to intercept the entire GSSAPI - communication and detour to the gssproxy - daemon. When the interposer plugin is installed two other - conditions need to be met in order to activate it: - - - - a) interposer configuration file - - The plugin needs to be manually enabled in the - /etc/gss/mech file. - - - - - b) gssproxy environment variable - - - The interposer plugin will not forward to the - gssproxy daemon unless the environment variable - named GSS_USE_PROXY=yes is set. - - - - - - Furthermore, the interposer plugin can be configured to behave in - different ways when called from the GSSAPI. This behavior is - controlled via the GSSPROXY_BEHAVIOR - environment variable. It accepts four different values: - - - - LOCAL_ONLY - - All commands received with this setting will cause - to immediately reenter the GSSAPI w/o any interaction - with the gssproxy daemon. When the request cannot be - processed it will just fail. This is the default - behavior when the - GSSPROXY_BEHAVIOR environment - variable is not set at all. - - - - - LOCAL_FIRST - - All commands received with this setting will cause - to immediately reenter the GSSAPI. When the local - GSSAPI cannot process the request, it will resend the - request to the gssproxy daemon. - - - - - REMOTE_FIRST - - All commands received with this setting will be - forwarded to the gssproxy daemon first. If the request - cannot be handled there, the request will reenter the - local GSSAPI. - - - - - REMOTE_ONLY - - This setting is currently not fully implemented and - therefor not supported. - - - - - - Finally the interposer may need to use a special per-service - socket in order to communicate with gssproxy. The path to this - socket is set via the GSSPROXY_SOCKET - environment variable. - - - - - SEE ALSO - - - gssproxy.conf5 - and - - gssproxy8 - . - - - - diff --git a/proxy/man/gssproxy-mech.8.xml.in b/proxy/man/gssproxy-mech.8.xml.in new file mode 100644 index 0000000..b2d008c --- /dev/null +++ b/proxy/man/gssproxy-mech.8.xml.in @@ -0,0 +1,133 @@ + + + +GssProxy GSSAPI mechanism manual page + + + GSS Proxy + GSS-Proxy - http://fedorahosted.org/gss-proxy + + + + gssproxy-mech + 8 + + + + gssproxy-mech + GssProxy GSSAPI mechanism plugin + + + + + proxymech_v1 2.16.840.1.113730.3.8.15.1 /usr/lib64/gssproxy/proxymech.so + + options + + + + + + DESCRIPTION + + The gssproxy proxymech module is a interposer plugin that is + loaded by GSSAPI. It is enabled by + /etc/gss/mech configuration file. + + + The interposer plugin allows to intercept the entire GSSAPI + communication and detour to the gssproxy + daemon. When the interposer plugin is installed two other + conditions need to be met in order to activate it: + + + + a) interposer configuration file + + The plugin needs to be manually enabled in the + /etc/gss/mech file. + + + + + b) gssproxy environment variable + + + The interposer plugin will not forward to the + gssproxy daemon unless the environment variable + named GSS_USE_PROXY=yes is set. + + + + + + Furthermore, the interposer plugin can be configured to behave in + different ways when called from the GSSAPI. This behavior is + controlled via the GSSPROXY_BEHAVIOR + environment variable. It accepts four different values: + + + + LOCAL_ONLY + + All commands received with this setting will cause + to immediately reenter the GSSAPI w/o any interaction + with the gssproxy daemon. When the request cannot be + processed it will just fail. This is the default + behavior when the + GSSPROXY_BEHAVIOR environment + variable is not set at all. + + + + + LOCAL_FIRST + + All commands received with this setting will cause + to immediately reenter the GSSAPI. When the local + GSSAPI cannot process the request, it will resend the + request to the gssproxy daemon. + + + + + REMOTE_FIRST + + All commands received with this setting will be + forwarded to the gssproxy daemon first. If the request + cannot be handled there, the request will reenter the + local GSSAPI. + + + + + REMOTE_ONLY + + This setting is currently not fully implemented and + therefor not supported. + + + + + + Finally the interposer may need to use a special per-service + socket in order to communicate with gssproxy. The path to this + socket is set via the GSSPROXY_SOCKET + environment variable. + + + + + SEE ALSO + + + gssproxy.conf5 + and + + gssproxy8 + . + + + + -- cgit