version 1.201, 2005/03/01 10:40:27 |
version 1.202, 2005/03/01 14:47:58 |
|
|
.Nd OpenSSH SSH client (remote login program) |
.Nd OpenSSH SSH client (remote login program) |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm ssh |
.Nm ssh |
|
.Bk -words |
.Op Fl 1246AaCfgkMNnqsTtVvXxY |
.Op Fl 1246AaCfgkMNnqsTtVvXxY |
.Op Fl b Ar bind_address |
.Op Fl b Ar bind_address |
.Op Fl c Ar cipher_spec |
.Op Fl c Ar cipher_spec |
.Bk -words |
|
.Op Fl D Ar port |
.Op Fl D Ar port |
.Op Fl e Ar escape_char |
.Op Fl e Ar escape_char |
.Op Fl F Ar configfile |
.Op Fl F Ar configfile |
.Op Fl i Ar identity_file |
.Op Fl i Ar identity_file |
.Oo Fl L Xo |
.Oo Fl L\ \& |
.Sm off |
.Sm off |
.Oo Ar bind_address : Oc |
.Oo Ar bind_address : Oc |
.Ar port : |
.Ar port : host : hostport |
.Ar host : |
|
.Ar hostport |
|
.Sm on |
.Sm on |
.Xc |
|
.Oc |
.Oc |
.Op Fl l Ar login_name |
.Op Fl l Ar login_name |
.Op Fl m Ar mac_spec |
.Op Fl m Ar mac_spec |
.Op Fl O Ar ctl_cmd |
.Op Fl O Ar ctl_cmd |
.Op Fl o Ar option |
.Op Fl o Ar option |
.Bk -words |
|
.Op Fl p Ar port |
.Op Fl p Ar port |
.Ek |
.Oo Fl R\ \& |
.Oo Fl R Xo |
|
.Sm off |
.Sm off |
.Oo Ar bind_address : Oc |
.Oo Ar bind_address : Oc |
.Ar port : |
.Ar port : host : hostport |
.Ar host : |
|
.Ar hostport |
|
.Sm on |
.Sm on |
.Xc |
|
.Oc |
.Oc |
.Op Fl S Ar ctl_path |
.Op Fl S Ar ctl_path |
.Oo Ar user Ns @ Oc Ns Ar hostname |
.Oo Ar user Ns @ Oc Ns Ar hostname |
.Op Ar command |
.Op Ar command |
|
.Ek |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
(SSH client) is a program for logging into a remote machine and for |
(SSH client) is a program for logging into a remote machine and for |
|
|
IPv6 addresses can be specified with an alternative syntax: |
IPv6 addresses can be specified with an alternative syntax: |
.Sm off |
.Sm off |
.Xo |
.Xo |
.Oo Ar bind_address / Oc |
.Oo Ar bind_address No / Oc |
.Ar port No / Ar host No / |
.Ar port No / Ar host No / |
.Ar hostport |
.Ar hostport |
.Xc |
.Xc |
|
|
.Ar bind_address |
.Ar bind_address |
of |
of |
.Dq localhost |
.Dq localhost |
indicates that the listening port be bound for local use only, while an |
indicates that the listening port be bound for local use only, while an |
empty address or |
empty address or |
.Dq * |
.Sq * |
indicates that the port should be available from all interfaces. |
indicates that the port should be available from all interfaces. |
.It Fl l Ar login_name |
.It Fl l Ar login_name |
Specifies the user to log in as on the remote machine. |
Specifies the user to log in as on the remote machine. |
|
|
logging in as root on the remote machine. |
logging in as root on the remote machine. |
IPv6 addresses can be specified by enclosing the address in square braces or |
IPv6 addresses can be specified by enclosing the address in square braces or |
using an alternative syntax: |
using an alternative syntax: |
.Xo |
|
.Sm off |
.Sm off |
.Oo Ar bind_address / Oc |
.Xo |
.Ar host/port/hostport |
.Oo Ar bind_address No / Oc |
.Sm on |
.Ar host No / Ar port No / |
|
.Ar hostport |
.Xc . |
.Xc . |
|
.Sm on |
.Pp |
.Pp |
By default, the listening socket on the server will be bound to the loopback |
By default, the listening socket on the server will be bound to the loopback |
interface only. |
interface only. |
This may be overriden by specifying a |
This may be overriden by specifying a |
.Ar bind_address . |
.Ar bind_address . |
An empty |
An empty |
.Ar bind_address , |
.Ar bind_address , |
or the address |
or the address |
.Ql * |
.Ql * , |
indicates that the remote socket should listen on all interfaces. |
indicates that the remote socket should listen on all interfaces. |
Specifying a remote |
Specifying a remote |
.Ar bind_address |
.Ar bind_address |
will only succeed if the server's |
will only succeed if the server's |
.Cm GatewayPorts |
.Cm GatewayPorts |
option is enabled (see |
option is enabled (see |
.Xr sshd_config 5 ). |
.Xr sshd_config 5 ) . |
.It Fl S Ar ctl_path |
.It Fl S Ar ctl_path |
Specifies the location of a control socket for connection sharing. |
Specifies the location of a control socket for connection sharing. |
Refer to the description of |
Refer to the description of |