summaryrefslogtreecommitdiff
path: root/ssh_config.5
diff options
context:
space:
mode:
authordtucker@openbsd.org <dtucker@openbsd.org>2020-07-17 03:23:10 +0000
committerDamien Miller <djm@mindrot.org>2020-07-17 13:52:46 +1000
commitc4f239944a4351810fd317edf408bdcd5c0102d9 (patch)
treeb2c83f10aad596cc6eba01f94eafe3b43a6bae42 /ssh_config.5
parentdbaaa01daedb423c38124a72c471982fb08a16fb (diff)
downloadopenssh-git-c4f239944a4351810fd317edf408bdcd5c0102d9.tar.gz
upstream: Add %-TOKEN, environment variable and tilde expansion to
UserKnownHostsFile, allowing the file to be automagically split up in the configuration (eg bz#1654). ok djm@, man page parts jmc@ OpenBSD-Commit-ID: 7e1b406caf147638bb51558836a72d6cc0bd1b18
Diffstat (limited to 'ssh_config.5')
-rw-r--r--ssh_config.518
1 files changed, 13 insertions, 5 deletions
diff --git a/ssh_config.5 b/ssh_config.5
index d5c561a1..fce59d13 100644
--- a/ssh_config.5
+++ b/ssh_config.5
@@ -33,8 +33,8 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $OpenBSD: ssh_config.5,v 1.328 2020/05/29 05:48:39 jmc Exp $
-.Dd $Mdocdate: May 29 2020 $
+.\" $OpenBSD: ssh_config.5,v 1.329 2020/07/17 03:23:10 dtucker Exp $
+.Dd $Mdocdate: July 17 2020 $
.Dt SSH_CONFIG 5
.Os
.Sh NAME
@@ -1738,6 +1738,12 @@ having to remember to give the user name on the command line.
.It Cm UserKnownHostsFile
Specifies one or more files to use for the user
host key database, separated by whitespace.
+Each filename may use tilde notation to refer to the user's home directory,
+the tokens described in the
+.Sx TOKENS
+section and environment variables as described in the
+.Sx ENVIRONMENT VARIABLES
+section.
The default is
.Pa ~/.ssh/known_hosts ,
.Pa ~/.ssh/known_hosts2 .
@@ -1874,8 +1880,9 @@ The local username.
.Cm LocalForward ,
.Cm Match exec ,
.Cm RemoteCommand ,
+.Cm RemoteForward ,
and
-.Cm RemoteForward
+.Com UserKnownHostsFile
accept the tokens %%, %C, %d, %h, %i, %L, %l, %n, %p, %r, and %u.
.Pp
.Cm Hostname
@@ -1899,9 +1906,10 @@ returned and the setting for that keyword will be ignored.
The keywords
.Cm CertificateFile ,
.Cm ControlPath ,
-.Cm IdentityAgent
-and
+.Cm IdentityAgent ,
.Cm IdentityFile
+and
+.Cm UserKnownHostsFile
support environment variables.
The keywords
.Cm LocalForward