diff options
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 |