diff options
Diffstat (limited to 'ssh_config.5')
| -rw-r--r-- | ssh_config.5 | 52 |
1 files changed, 50 insertions, 2 deletions
diff --git a/ssh_config.5 b/ssh_config.5 index 9ddd6b8a6..f35f468f4 100644 --- a/ssh_config.5 +++ b/ssh_config.5 | |||
| @@ -33,8 +33,8 @@ | |||
| 33 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | 33 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
| 34 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 34 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 35 | .\" | 35 | .\" |
| 36 | .\" $OpenBSD: ssh_config.5,v 1.168 2013/08/20 06:56:07 jmc Exp $ | 36 | .\" $OpenBSD: ssh_config.5,v 1.169 2013/10/14 22:22:05 djm Exp $ |
| 37 | .Dd $Mdocdate: August 20 2013 $ | 37 | .Dd $Mdocdate: October 14 2013 $ |
| 38 | .Dt SSH_CONFIG 5 | 38 | .Dt SSH_CONFIG 5 |
| 39 | .Os | 39 | .Os |
| 40 | .Sh NAME | 40 | .Sh NAME |
| @@ -100,6 +100,8 @@ keywords are case-insensitive and arguments are case-sensitive): | |||
| 100 | .It Cm Host | 100 | .It Cm Host |
| 101 | Restricts the following declarations (up to the next | 101 | Restricts the following declarations (up to the next |
| 102 | .Cm Host | 102 | .Cm Host |
| 103 | or | ||
| 104 | .Cm Match | ||
| 103 | keyword) to be only for those hosts that match one of the patterns | 105 | keyword) to be only for those hosts that match one of the patterns |
| 104 | given after the keyword. | 106 | given after the keyword. |
| 105 | If more than one pattern is provided, they should be separated by whitespace. | 107 | If more than one pattern is provided, they should be separated by whitespace. |
| @@ -124,6 +126,52 @@ matches. | |||
| 124 | See | 126 | See |
| 125 | .Sx PATTERNS | 127 | .Sx PATTERNS |
| 126 | for more information on patterns. | 128 | for more information on patterns. |
| 129 | .It Cm Match | ||
| 130 | Restricts the following declarations (up to the next | ||
| 131 | .Cm Host | ||
| 132 | or | ||
| 133 | .Cm Match | ||
| 134 | keyword) to be used only when the conditions following the | ||
| 135 | .Cm Match | ||
| 136 | keyword are satisfied. | ||
| 137 | Match conditions are specified using one or more keyword/criteria pairs. | ||
| 138 | The available keywords are: | ||
| 139 | .Cm command , | ||
| 140 | .Cm host , | ||
| 141 | .Cm originalhost , | ||
| 142 | .Cm user , | ||
| 143 | and | ||
| 144 | .Cm localuser . | ||
| 145 | .Pp | ||
| 146 | The criteria for the | ||
| 147 | .Cm command | ||
| 148 | keyword is a path to a command that is executed. | ||
| 149 | If the command returns a zero exit status then the condition is considered true. | ||
| 150 | Commands containing whitespace characters must be quoted. | ||
| 151 | .Pp | ||
| 152 | The other keywords' criteria must be single entries or comma-separated | ||
| 153 | lists and may use the wildcard and negation operators described in the | ||
| 154 | .Sx PATTERNS | ||
| 155 | section. | ||
| 156 | The criteria for the | ||
| 157 | .Cm host | ||
| 158 | keyword are matched against the target hostname, after any substitution | ||
| 159 | by the | ||
| 160 | .Cm Hostname | ||
| 161 | option. | ||
| 162 | The | ||
| 163 | .Cm originalhost | ||
| 164 | keyword matches against the hostname as it was specified on the command-line. | ||
| 165 | The | ||
| 166 | .Cm user | ||
| 167 | keyword matches against the target username on the remote host. | ||
| 168 | The | ||
| 169 | .Cm localuser | ||
| 170 | keyword matches against the name of the local user running | ||
| 171 | .Xr ssh 1 | ||
| 172 | (this keyword may be useful in system-wide | ||
| 173 | .Nm | ||
| 174 | files). | ||
| 127 | .It Cm AddressFamily | 175 | .It Cm AddressFamily |
| 128 | Specifies which address family to use when connecting. | 176 | Specifies which address family to use when connecting. |
| 129 | Valid arguments are | 177 | Valid arguments are |