'\" t
.\"     Title: sss_ssh_knownhostsproxy
.\"    Author: The SSSD upstream - http://fedorahosted.org/sssd
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 03/04/2013
.\"    Manual: SSSD Manual pages
.\"    Source: SSSD
.\"  Language: English
.\"
.TH "SSS_SSH_KNOWNHOSTSPR" "1" "03/04/2013" "SSSD" "SSSD Manual pages"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
sss_ssh_knownhostsproxy \- get OpenSSH host keys
.SH "SYNOPSIS"
.HP \w'\fBsss_ssh_knownhostsproxy\fR\ 'u
\fBsss_ssh_knownhostsproxy\fR [\fIoptions\fR] \fIHOST\fR [\fIPROXY_COMMAND\fR]
.SH "DESCRIPTION"
.PP

\fBsss_ssh_knownhostsproxy\fR
acquires SSH host public keys for host
\fIHOST\fR, stores them in a custom OpenSSH known_hosts file (see the
\(lqSSH_KNOWN_HOSTS FILE FORMAT\(rq
section of
\fBsshd\fR(8)
for more information)
/var/lib/sss/pubconf/known_hosts
and estabilishes connection to the host\&.
.PP
If
\fIPROXY_COMMAND\fR
is specified, it is used to create the connection to the host instead of opening a socket\&.
.PP

\fBssh\fR(1)
can be configured to use
\fBsss_ssh_knownhostsproxy\fR
for host key authentication by using the following directives for
\fBssh\fR(1)
configuration:
.sp
.if n \{\
.RS 4
.\}
.nf
ProxyCommand /usr/bin/sss_ssh_knownhostsproxy \-p %p %h
GlobalKnownHostsFile2 /var/lib/sss/pubconf/known_hosts
.fi
.if n \{\
.RE
.\}
.PP

\fI This is an experimental feature, please use http://fedorahosted\&.org/sssd to report any issues\&. \fR
.SH "OPTIONS"
.PP
\fB\-p\fR,\fB\-\-port\fR \fIPORT\fR
.RS 4
Use port
\fIPORT\fR
to connect to the host\&. By default, port 22 is used\&.
.RE
.PP
\fB\-d\fR,\fB\-\-domain\fR \fIDOMAIN\fR
.RS 4
Search for host public keys in SSSD domain
\fIDOMAIN\fR\&.
.RE
.PP
\fB\-h\fR,\fB\-\-help\fR
.RS 4
Display help message and exit\&.
.RE
.SH "SEE ALSO"
.PP

\fBssh\fR(8),
\fBssh_config\fR(5),
\fBsss_ssh_authorizedkeys\fR(1)\&.
.SH "AUTHORS"
.PP
\fBThe SSSD upstream \- http://fedorahosted\&.org/sssd\fR