summaryrefslogtreecommitdiff
path: root/src/man
diff options
context:
space:
mode:
authorJan Cholasta <jcholast@redhat.com>2012-02-03 22:56:13 +0100
committerJakub Hrozek <jhrozek@redhat.com>2012-02-07 00:26:58 +0100
commit9a3e40dc49c1e38bf58e45be5adff37615f3910b (patch)
tree604797303c0fd8baa7e7a66c35427344f566344c /src/man
parent558998ce664055a75595371118f818084d8f2b23 (diff)
downloadsssd-9a3e40dc49c1e38bf58e45be5adff37615f3910b.tar.gz
sssd-9a3e40dc49c1e38bf58e45be5adff37615f3910b.tar.bz2
sssd-9a3e40dc49c1e38bf58e45be5adff37615f3910b.zip
SSH: OpenSSH known_hosts client
Diffstat (limited to 'src/man')
-rw-r--r--src/man/Makefile.am2
-rw-r--r--src/man/sss_ssh_knownhostsproxy.1.xml120
2 files changed, 121 insertions, 1 deletions
diff --git a/src/man/Makefile.am b/src/man/Makefile.am
index f6307715..c0c2281e 100644
--- a/src/man/Makefile.am
+++ b/src/man/Makefile.am
@@ -39,7 +39,7 @@ man_MANS = \
sssd-krb5.5 sssd-ipa.5 sssd-simple.5 \
sssd_krb5_locator_plugin.8 sss_groupshow.8 \
pam_sss.8 sss_obfuscate.8 sss_cache.8 sss_debuglevel.8 \
- sss_ssh_authorizedkeys.1
+ sss_ssh_authorizedkeys.1 sss_ssh_knownhostsproxy.1
EXTRA_DIST = $(man_MANS:%=%.xml) $(wildcard $(srcdir)/include/*.xml)
SUFFIXES = .1.xml .1 .3.xml .3 .5.xml .5 .8.xml .8
diff --git a/src/man/sss_ssh_knownhostsproxy.1.xml b/src/man/sss_ssh_knownhostsproxy.1.xml
new file mode 100644
index 00000000..1cb16049
--- /dev/null
+++ b/src/man/sss_ssh_knownhostsproxy.1.xml
@@ -0,0 +1,120 @@
+<?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>SSSD Manual pages</title>
+<refentry>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/upstream.xml" />
+
+ <refmeta>
+ <refentrytitle>sss_ssh_knownhostsproxy</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv id='name'>
+ <refname>sss_ssh_knownhostsproxy</refname>
+ <refpurpose>get OpenSSH host keys</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>sss_ssh_knownhostsproxy</command>
+ <arg choice='opt'>
+ <replaceable>options</replaceable>
+ </arg>
+ <arg choice='plain'><replaceable>HOST</replaceable></arg>
+ <arg choice='opt'><replaceable>PROXY_COMMAND</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>sss_ssh_knownhostsproxy</command> acquires SSH host
+ public keys for host <replaceable>HOST</replaceable>, stores
+ them in a custom OpenSSH known_hosts file (see the
+ <quote>SSH_KNOWN_HOSTS FILE FORMAT</quote> section of
+ <citerefentry><refentrytitle>sshd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> for more
+ information) and estabilishes connection to the host.
+ </para>
+ <para>
+ If <replaceable>PROXY_COMMAND</replaceable> is specified,
+ it is used to create the connection to the host instead of
+ opening a socket.
+ </para>
+ <para>
+ <citerefentry><refentrytitle>ssh</refentrytitle>
+ <manvolnum>1</manvolnum></citerefentry> can be configured to
+ use <command>sss_ssh_knownhostsproxy</command> for host key
+ authentication by using the following directives for
+ <citerefentry><refentrytitle>ssh</refentrytitle>
+ <manvolnum>1</manvolnum></citerefentry> configuration:
+<programlisting>
+ProxyCommand /usr/bin/sss_ssh_knownhostsproxy -p %p %h
+UserKnownHostsFile2 .ssh/sss_known_hosts
+</programlisting>
+ </para>
+ <para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/experimental.xml" />
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist remap='IP'>
+ <varlistentry>
+ <term>
+ <option>-f</option>,<option>--file</option>
+ <replaceable>FILE</replaceable>
+ </term>
+ <listitem>
+ <para>
+ Store host public keys in file <replaceable>FILE</replaceable>.
+ By default, <filename>.ssh/sss_known_hosts</filename> is used.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <option>-p</option>,<option>--port</option>
+ <replaceable>PORT</replaceable>
+ </term>
+ <listitem>
+ <para>
+ Use port <replaceable>PORT</replaceable> to connect to the host.
+ By default, port 22 is used.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <option>-d</option>,<option>--domain</option>
+ <replaceable>DOMAIN</replaceable>
+ </term>
+ <listitem>
+ <para>
+ Search for host public keys in SSSD domain <replaceable>DOMAIN</replaceable>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/param_help.xml" />
+ </variablelist>
+ </refsect1>
+
+ <refsect1 id='see_also'>
+ <title>SEE ALSO</title>
+ <para>
+ <citerefentry>
+ <refentrytitle>ssh</refentrytitle><manvolnum>8</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>ssh_config</refentrytitle><manvolnum>5</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>sss_ssh_authorizedkeys</refentrytitle><manvolnum>1</manvolnum>
+ </citerefentry>.
+ </para>
+ </refsect1>
+</refentry>
+</reference>