summaryrefslogtreecommitdiff
path: root/ssh_config.5
diff options
context:
space:
mode:
Diffstat (limited to 'ssh_config.5')
-rw-r--r--ssh_config.554
1 files changed, 43 insertions, 11 deletions
diff --git a/ssh_config.5 b/ssh_config.5
index 44107bfe7..5f1ced5b6 100644
--- a/ssh_config.5
+++ b/ssh_config.5
@@ -34,7 +34,7 @@
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.79 2006/02/19 20:12:25 jmc Exp $ 37.\" $OpenBSD: ssh_config.5,v 1.80 2006/02/24 10:25:14 jmc Exp $
38.Dd September 25, 1999 38.Dd September 25, 1999
39.Dt SSH_CONFIG 5 39.Dt SSH_CONFIG 5
40.Os 40.Os
@@ -73,13 +73,47 @@ The matched host name is the one given on the command line.
73Since the first obtained value for each parameter is used, more 73Since the first obtained value for each parameter is used, more
74host-specific declarations should be given near the beginning of the 74host-specific declarations should be given near the beginning of the
75file, and general defaults at the end. 75file, and general defaults at the end.
76.Sh PATTERNS
77A
78.Em pattern
79consists of zero or more non-whitespace characters,
80.Sq *
81(a wildcard that matches zero or more characters),
82or
83.Sq ?\&
84(a wildcard that matches exactly one character).
85For example, to specify a set of declarations for any host in the
86.Dq .co.uk
87set of domains,
88the following pattern could be used:
89.Pp
90.Dl Host *.co.uk
91.Pp
92The following pattern
93would match any host in the 192.168.0.[0-9] network range:
76.Pp 94.Pp
95.Dl Host 192.168.0.?
96.Pp
97A
98.Em pattern-list
99is a comma-separated list of patterns.
100Patterns within pattern-lists may be negated
101by preceding them with an exclamation mark
102.Pq Sq !\& .
103For example,
104to allow a key to be used from anywhere within an organisation
105except from the
106.Dq dialup
107pool,
108the following entry (in authorized_keys) could be used:
109.Pp
110.Dl from=\&"!*.dialup.example.com,*.example.com\&"
111.Sh FILE FORMAT
77The configuration file has the following format: 112The configuration file has the following format:
78.Pp 113.Pp
79Empty lines and lines starting with 114Empty lines and lines starting with
80.Ql # 115.Ql #
81are comments. 116are comments.
82.Pp
83Otherwise a line is of the format 117Otherwise a line is of the format
84.Dq keyword arguments . 118.Dq keyword arguments .
85Configuration options may be separated by whitespace or 119Configuration options may be separated by whitespace or
@@ -103,15 +137,13 @@ Restricts the following declarations (up to the next
103.Cm Host 137.Cm Host
104keyword) to be only for those hosts that match one of the patterns 138keyword) to be only for those hosts that match one of the patterns
105given after the keyword. 139given after the keyword.
106.Ql \&*
107and
108.Ql \&?
109can be used as wildcards in the
110patterns.
111A single 140A single
112.Ql \&* 141.Ql \&*
113as a pattern can be used to provide global 142as a pattern can be used to provide global
114defaults for all hosts. 143defaults for all hosts.
144See
145.Sx PATTERNS
146for more information on patterns.
115The host is the 147The host is the
116.Ar hostname 148.Ar hostname
117argument given on the command line (i.e., the name is not converted to 149argument given on the command line (i.e., the name is not converted to
@@ -805,10 +837,10 @@ Refer to
805in 837in
806.Xr sshd_config 5 838.Xr sshd_config 5
807for how to configure the server. 839for how to configure the server.
808Variables are specified by name, which may contain the wildcard characters 840Variables are specified by name, which may contain wildcard characters.
809.Ql \&* 841See
810and 842.Sx PATTERNS
811.Ql \&? . 843for more information on patterns.
812Multiple environment variables may be separated by whitespace or spread 844Multiple environment variables may be separated by whitespace or spread
813across multiple 845across multiple
814.Cm SendEnv 846.Cm SendEnv