diff options
author | Colin Watson <cjwatson@debian.org> | 2008-07-22 19:45:18 +0000 |
---|---|---|
committer | Colin Watson <cjwatson@debian.org> | 2008-07-22 19:45:18 +0000 |
commit | 137d76ba65883aa8143af1fcad83b57e7badef0c (patch) | |
tree | f426e804bb5248ceafedfab7bb78ae6e6752942c /ssh_config.5 | |
parent | dac7d049dad31f5f84d421d4eb628a7e13f977d7 (diff) | |
parent | ef94e5613d37bcbf880f21ee6094e4b1c7683a4c (diff) |
* New upstream release (closes: #474301). Important changes not previously
backported to 4.7p1:
- 4.9/4.9p1 (http://www.openssh.com/txt/release-4.9):
+ Added chroot(2) support for sshd(8), controlled by a new option
"ChrootDirectory" (closes: #139047, LP: #24777).
+ Linked sftp-server(8) into sshd(8). The internal sftp server is used
when the command "internal-sftp" is specified in a Subsystem or
ForceCommand declaration. When used with ChrootDirectory, the
internal sftp server requires no special configuration of files
inside the chroot environment.
+ Added a protocol extension method "posix-rename@openssh.com" for
sftp-server(8) to perform POSIX atomic rename() operations; sftp(1)
prefers this if available (closes: #308561).
+ Removed the fixed limit of 100 file handles in sftp-server(8).
+ ssh(8) will now skip generation of SSH protocol 1 ephemeral server
keys when in inetd mode and protocol 2 connections are negotiated.
This speeds up protocol 2 connections to inetd-mode servers that
also allow Protocol 1.
+ Accept the PermitRootLogin directive in a sshd_config(5) Match
block. Allows for, e.g. permitting root only from the local network.
+ Reworked sftp(1) argument splitting and escaping to be more
internally consistent (i.e. between sftp commands) and more
consistent with sh(1). Please note that this will change the
interpretation of some quoted strings, especially those with
embedded backslash escape sequences.
+ Support "Banner=none" in sshd_config(5) to disable sending of a
pre-login banner (e.g. in a Match block).
+ ssh(1) ProxyCommands are now executed with $SHELL rather than
/bin/sh.
+ ssh(1)'s ConnectTimeout option is now applied to both the TCP
connection and the SSH banner exchange (previously it just covered
the TCP connection). This allows callers of ssh(1) to better detect
and deal with stuck servers that accept a TCP connection but don't
progress the protocol, and also makes ConnectTimeout useful for
connections via a ProxyCommand.
+ scp(1) incorrectly reported "stalled" on slow copies (closes:
#140828).
+ scp(1) date underflow for timestamps before epoch.
+ ssh(1) used the obsolete SIG DNS RRtype for host keys in DNS,
instead of the current standard RRSIG.
+ Correctly drain ACKs when a sftp(1) upload write fails midway,
avoids a fatal() exit from what should be a recoverable condition.
+ Fixed ssh-keygen(1) selective host key hashing (i.e. "ssh-keygen -HF
hostname") to not include any IP address in the data to be hashed.
+ Make ssh(1) skip listening on the IPv6 wildcard address when a
binding address of 0.0.0.0 is used against an old SSH server that
does not support the RFC4254 syntax for wildcard bind addresses.
+ Enable IPV6_V6ONLY socket option on sshd(8) listen socket, as is
already done for X11/TCP forwarding sockets (closes: #439661).
+ Fix FD leak that could hang a ssh(1) connection multiplexing master.
+ Make ssh(1) -q option documentation consistent with reality.
+ Fixed sshd(8) PAM support not calling pam_session_close(), or
failing to call it with root privileges (closes: #372680).
+ Fix activation of OpenSSL engine support when requested in configure
(LP: #119295).
- 5.1/5.1p1 (http://www.openssh.com/txt/release-5.1):
+ Introduce experimental SSH Fingerprint ASCII Visualisation to ssh(1)
and ssh-keygen(1). Visual fingerprint display is controlled by a new
ssh_config(5) option "VisualHostKey". The intent is to render SSH
host keys in a visual form that is amenable to easy recall and
rejection of changed host keys.
+ sshd_config(5) now supports CIDR address/masklen matching in "Match
address" blocks, with a fallback to classic wildcard matching.
+ sshd(8) now supports CIDR matching in ~/.ssh/authorized_keys
from="..." restrictions, also with a fallback to classic wildcard
matching.
+ Added an extended test mode (-T) to sshd(8) to request that it write
its effective configuration to stdout and exit. Extended test mode
also supports the specification of connection parameters (username,
source address and hostname) to test the application of
sshd_config(5) Match rules.
+ ssh(1) now prints the number of bytes transferred and the overall
connection throughput for SSH protocol 2 sessions when in verbose
mode (previously these statistics were displayed for protocol 1
connections only).
+ sftp-server(8) now supports extension methods statvfs@openssh.com
and fstatvfs@openssh.com that implement statvfs(2)-like operations.
+ sftp(1) now has a "df" command to the sftp client that uses the
statvfs@openssh.com to produce a df(1)-like display of filesystem
space and inode utilisation (requires statvfs@openssh.com support on
the server).
+ Added a MaxSessions option to sshd_config(5) to allow control of the
number of multiplexed sessions supported over a single TCP
connection. This allows increasing the number of allowed sessions
above the previous default of 10, disabling connection multiplexing
(MaxSessions=1) or disallowing login/shell/subsystem sessions
entirely (MaxSessions=0).
+ Added a no-more-sessions@openssh.com global request extension that
is sent from ssh(1) to sshd(8) when the client knows that it will
never request another session (i.e. when session multiplexing is
disabled). This allows a server to disallow further session requests
and terminate the session in cases where the client has been
hijacked.
+ ssh-keygen(1) now supports the use of the -l option in combination
with -F to search for a host in ~/.ssh/known_hosts and display its
fingerprint.
+ ssh-keyscan(1) now defaults to "rsa" (protocol 2) keys, instead of
"rsa1".
+ Added an AllowAgentForwarding option to sshd_config(8) to control
whether authentication agent forwarding is permitted. Note that this
is a loose control, as a client may install their own unofficial
forwarder.
+ ssh(1) and sshd(8): avoid unnecessary malloc/copy/free when
receiving network data, resulting in a ~10% speedup.
+ ssh(1) and sshd(8) will now try additional addresses when connecting
to a port forward destination whose DNS name resolves to more than
one address. The previous behaviour was to try the only first
address and give up if that failed.
+ ssh(1) and sshd(8) now support signalling that channels are
half-closed for writing, through a channel protocol extension
notification "eow@openssh.com". This allows propagation of closed
file descriptors, so that commands such as "ssh -2 localhost od
/bin/ls | true" do not send unnecessary data over the wire.
+ sshd(8): increased the default size of ssh protocol 1 ephemeral keys
from 768 to 1024 bits.
+ When ssh(1) has been requested to fork after authentication ("ssh
-f") with ExitOnForwardFailure enabled, delay the fork until after
replies for any -R forwards have been seen. Allows for robust
detection of -R forward failure when using -f.
+ "Match group" blocks in sshd_config(5) now support negation of
groups. E.g. "Match group staff,!guests".
+ sftp(1) and sftp-server(8) now allow chmod-like operations to set
set[ug]id/sticky bits.
+ The MaxAuthTries option is now permitted in sshd_config(5) match
blocks.
+ Multiplexed ssh(1) sessions now support a subset of the ~ escapes
that are available to a primary connection.
+ ssh(1) connection multiplexing will now fall back to creating a new
connection in most error cases (closes: #352830).
+ Make ssh(1) deal more gracefully with channel requests that fail.
Previously it would optimistically assume that requests would always
succeed, which could cause hangs if they did not (e.g. when the
server runs out of file descriptors).
+ ssh(1) now reports multiplexing errors via the multiplex slave's
stderr where possible (subject to LogLevel in the mux master).
+ Prevent sshd(8) from erroneously applying public key restrictions
leaned from ~/.ssh/authorized_keys to other authentication methods
when public key authentication subsequently fails (LP: #161047).
+ Fixed an UMAC alignment problem that manifested on Itanium
platforms.
Diffstat (limited to 'ssh_config.5')
-rw-r--r-- | ssh_config.5 | 67 |
1 files changed, 42 insertions, 25 deletions
diff --git a/ssh_config.5 b/ssh_config.5 index 411e9fd34..1b8b8da5d 100644 --- a/ssh_config.5 +++ b/ssh_config.5 | |||
@@ -34,8 +34,8 @@ | |||
34 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | 34 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
35 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 35 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
36 | .\" | 36 | .\" |
37 | .\" $OpenBSD: ssh_config.5,v 1.102 2007/08/15 12:13:41 stevesk Exp $ | 37 | .\" $OpenBSD: ssh_config.5,v 1.111 2008/06/26 11:46:31 grunk Exp $ |
38 | .Dd $Mdocdate: August 15 2007 $ | 38 | .Dd $Mdocdate: June 26 2008 $ |
39 | .Dt SSH_CONFIG 5 | 39 | .Dt SSH_CONFIG 5 |
40 | .Os | 40 | .Os |
41 | .Sh NAME | 41 | .Sh NAME |
@@ -119,6 +119,7 @@ Restricts the following declarations (up to the next | |||
119 | .Cm Host | 119 | .Cm Host |
120 | keyword) to be only for those hosts that match one of the patterns | 120 | keyword) to be only for those hosts that match one of the patterns |
121 | given after the keyword. | 121 | given after the keyword. |
122 | If more than one pattern is provided, they should be separated by whitepsace. | ||
122 | A single | 123 | A single |
123 | .Ql * | 124 | .Ql * |
124 | as a pattern can be used to provide global | 125 | as a pattern can be used to provide global |
@@ -145,9 +146,7 @@ If set to | |||
145 | passphrase/password querying will be disabled. | 146 | passphrase/password querying will be disabled. |
146 | In addition, the | 147 | In addition, the |
147 | .Cm ServerAliveInterval | 148 | .Cm ServerAliveInterval |
148 | and | 149 | option will be set to 300 seconds by default. |
149 | .Cm SetupTimeOut | ||
150 | options will both be set to 300 seconds by default. | ||
151 | This option is useful in scripts and other batch jobs where no user | 150 | This option is useful in scripts and other batch jobs where no user |
152 | is present to supply the password, | 151 | is present to supply the password, |
153 | and where it is desirable to detect a broken network swiftly. | 152 | and where it is desirable to detect a broken network swiftly. |
@@ -619,6 +618,14 @@ escape characters: | |||
619 | It is possible to have | 618 | It is possible to have |
620 | multiple identity files specified in configuration files; all these | 619 | multiple identity files specified in configuration files; all these |
621 | identities will be tried in sequence. | 620 | identities will be tried in sequence. |
621 | .It Cm KbdInteractiveAuthentication | ||
622 | Specifies whether to use keyboard-interactive authentication. | ||
623 | The argument to this keyword must be | ||
624 | .Dq yes | ||
625 | or | ||
626 | .Dq no . | ||
627 | The default is | ||
628 | .Dq yes . | ||
622 | .It Cm KbdInteractiveDevices | 629 | .It Cm KbdInteractiveDevices |
623 | Specifies the list of methods to use in keyboard-interactive authentication. | 630 | Specifies the list of methods to use in keyboard-interactive authentication. |
624 | Multiple method names must be comma-separated. | 631 | Multiple method names must be comma-separated. |
@@ -634,7 +641,22 @@ and | |||
634 | Specifies a command to execute on the local machine after successfully | 641 | Specifies a command to execute on the local machine after successfully |
635 | connecting to the server. | 642 | connecting to the server. |
636 | The command string extends to the end of the line, and is executed with | 643 | The command string extends to the end of the line, and is executed with |
637 | .Pa /bin/sh . | 644 | the user's shell. |
645 | The following escape character substitutions will be performed: | ||
646 | .Ql %d | ||
647 | (local user's home directory), | ||
648 | .Ql %h | ||
649 | (remote host name), | ||
650 | .Ql %l | ||
651 | (local host name), | ||
652 | .Ql %n | ||
653 | (host name as provided on the command line), | ||
654 | .Ql %p | ||
655 | (remote port), | ||
656 | .Ql %r | ||
657 | (remote user name) or | ||
658 | .Ql %u | ||
659 | (local user name). | ||
638 | This directive is ignored unless | 660 | This directive is ignored unless |
639 | .Cm PermitLocalCommand | 661 | .Cm PermitLocalCommand |
640 | has been enabled. | 662 | has been enabled. |
@@ -758,7 +780,7 @@ if version 2 is not available. | |||
758 | Specifies the command to use to connect to the server. | 780 | Specifies the command to use to connect to the server. |
759 | The command | 781 | The command |
760 | string extends to the end of the line, and is executed with | 782 | string extends to the end of the line, and is executed with |
761 | .Pa /bin/sh . | 783 | the user's shell. |
762 | In the command string, | 784 | In the command string, |
763 | .Ql %h | 785 | .Ql %h |
764 | will be substituted by the host name to | 786 | will be substituted by the host name to |
@@ -936,24 +958,9 @@ or 300 if the | |||
936 | option is set. | 958 | option is set. |
937 | This option applies to protocol version 2 only. | 959 | This option applies to protocol version 2 only. |
938 | .Cm ProtocolKeepAlives | 960 | .Cm ProtocolKeepAlives |
939 | is a Debian-specific compatibility alias for this option. | 961 | and |
940 | .It Cm SetupTimeOut | 962 | .Cm SetupTimeOut |
941 | Normally, | 963 | are Debian-specific compatibility aliases for this option. |
942 | .Nm ssh | ||
943 | blocks indefinitely whilst waiting to receive the ssh banner and other | ||
944 | setup protocol from the server, during the session setup. | ||
945 | This can cause | ||
946 | .Nm ssh | ||
947 | to hang under certain circumstances. | ||
948 | If this option is set, | ||
949 | .Nm ssh | ||
950 | will give up if no data from the server is received for the specified | ||
951 | number of seconds. | ||
952 | The argument must be an integer. | ||
953 | The default is 0 (disabled), or 300 if | ||
954 | .Cm BatchMode | ||
955 | is set. | ||
956 | This is a Debian-specific option. | ||
957 | .It Cm SmartcardDevice | 964 | .It Cm SmartcardDevice |
958 | Specifies which smartcard device to use. | 965 | Specifies which smartcard device to use. |
959 | The argument to this keyword is the device | 966 | The argument to this keyword is the device |
@@ -1127,6 +1134,16 @@ See also | |||
1127 | .Sx VERIFYING HOST KEYS | 1134 | .Sx VERIFYING HOST KEYS |
1128 | in | 1135 | in |
1129 | .Xr ssh 1 . | 1136 | .Xr ssh 1 . |
1137 | .It Cm VisualHostKey | ||
1138 | If this flag is set to | ||
1139 | .Dq yes , | ||
1140 | an ASCII art representation of the remote host key fingerprint is | ||
1141 | printed additionally to the hex fingerprint string. | ||
1142 | If this flag is set to | ||
1143 | .Dq no , | ||
1144 | only the hex fingerprint string will be printed. | ||
1145 | The default is | ||
1146 | .Dq no . | ||
1130 | .It Cm XAuthLocation | 1147 | .It Cm XAuthLocation |
1131 | Specifies the full pathname of the | 1148 | Specifies the full pathname of the |
1132 | .Xr xauth 1 | 1149 | .Xr xauth 1 |