summaryrefslogtreecommitdiff
path: root/sshd.8
diff options
context:
space:
mode:
Diffstat (limited to 'sshd.8')
-rw-r--r--sshd.840
1 files changed, 27 insertions, 13 deletions
diff --git a/sshd.8 b/sshd.8
index 37a7b58f6..22ab70e00 100644
--- a/sshd.8
+++ b/sshd.8
@@ -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: sshd.8,v 1.186 2002/06/22 16:45:29 stevesk Exp $ 37.\" $OpenBSD: sshd.8,v 1.193 2002/09/24 20:59:44 todd Exp $
38.Dd September 25, 1999 38.Dd September 25, 1999
39.Dt SSHD 8 39.Dt SSHD 8
40.Os 40.Os
@@ -203,7 +203,7 @@ The default is
203refuses to start if there is no configuration file. 203refuses to start if there is no configuration file.
204.It Fl g Ar login_grace_time 204.It Fl g Ar login_grace_time
205Gives the grace time for clients to authenticate themselves (default 205Gives the grace time for clients to authenticate themselves (default
206600 seconds). 206120 seconds).
207If the client fails to authenticate the user within 207If the client fails to authenticate the user within
208this many seconds, the server disconnects and exits. 208this many seconds, the server disconnects and exits.
209A value of zero indicates no limit. 209A value of zero indicates no limit.
@@ -350,7 +350,11 @@ Sets up basic environment.
350.It 350.It
351Reads 351Reads
352.Pa $HOME/.ssh/environment 352.Pa $HOME/.ssh/environment
353if it exists. 353if it exists and users are allowed to change their environment.
354See the
355.Cm PermitUserEnvironment
356option in
357.Xr sshd_config 5 .
354.It 358.It
355Changes to user's home directory. 359Changes to user's home directory.
356.It 360.It
@@ -385,9 +389,9 @@ Each RSA public key consists of the following fields, separated by
385spaces: options, bits, exponent, modulus, comment. 389spaces: options, bits, exponent, modulus, comment.
386Each protocol version 2 public key consists of: 390Each protocol version 2 public key consists of:
387options, keytype, base64 encoded key, comment. 391options, keytype, base64 encoded key, comment.
388The options fields 392The options field
389are optional; its presence is determined by whether the line starts 393is optional; its presence is determined by whether the line starts
390with a number or not (the option field never starts with a number). 394with a number or not (the options field never starts with a number).
391The bits, exponent, modulus and comment fields give the RSA key for 395The bits, exponent, modulus and comment fields give the RSA key for
392protocol version 1; the 396protocol version 1; the
393comment field is not used for anything (but may be convenient for the 397comment field is not used for anything (but may be convenient for the
@@ -398,7 +402,7 @@ or
398.Dq ssh-rsa . 402.Dq ssh-rsa .
399.Pp 403.Pp
400Note that lines in this file are usually several hundred bytes long 404Note that lines in this file are usually several hundred bytes long
401(because of the size of the RSA key modulus). 405(because of the size of the public key encoding).
402You don't want to type them in; instead, copy the 406You don't want to type them in; instead, copy the
403.Pa identity.pub , 407.Pa identity.pub ,
404.Pa id_dsa.pub 408.Pa id_dsa.pub
@@ -417,7 +421,7 @@ The following option specifications are supported (note
417that option keywords are case-insensitive): 421that option keywords are case-insensitive):
418.Bl -tag -width Ds 422.Bl -tag -width Ds
419.It Cm from="pattern-list" 423.It Cm from="pattern-list"
420Specifies that in addition to RSA authentication, the canonical name 424Specifies that in addition to public key authentication, the canonical name
421of the remote host must be present in the comma-separated list of 425of the remote host must be present in the comma-separated list of
422patterns 426patterns
423.Pf ( Ql * 427.Pf ( Ql *
@@ -429,7 +433,7 @@ patterns negated by prefixing them with
429.Ql ! ; 433.Ql ! ;
430if the canonical host name matches a negated pattern, the key is not accepted. 434if the canonical host name matches a negated pattern, the key is not accepted.
431The purpose 435The purpose
432of this option is to optionally increase security: RSA authentication 436of this option is to optionally increase security: public key authentication
433by itself does not trust the network or name servers or anything (but 437by itself does not trust the network or name servers or anything (but
434the key); however, if somebody somehow steals the key, the key 438the key); however, if somebody somehow steals the key, the key
435permits an intruder to log in from anywhere in the world. 439permits an intruder to log in from anywhere in the world.
@@ -447,7 +451,7 @@ one must not request a pty or should specify
447.Cm no-pty . 451.Cm no-pty .
448A quote may be included in the command by quoting it with a backslash. 452A quote may be included in the command by quoting it with a backslash.
449This option might be useful 453This option might be useful
450to restrict certain RSA keys to perform just a specific operation. 454to restrict certain public keys to perform just a specific operation.
451An example might be a key that permits remote backups but nothing else. 455An example might be a key that permits remote backups but nothing else.
452Note that the client may specify TCP/IP and/or X11 456Note that the client may specify TCP/IP and/or X11
453forwarding unless they are explicitly prohibited. 457forwarding unless they are explicitly prohibited.
@@ -458,6 +462,10 @@ logging in using this key.
458Environment variables set this way 462Environment variables set this way
459override other default environment values. 463override other default environment values.
460Multiple options of this type are permitted. 464Multiple options of this type are permitted.
465Environment processing is disabled by default and is
466controlled via the
467.Cm PermitUserEnvironment
468option.
461This option is automatically disabled if 469This option is automatically disabled if
462.Cm UseLogin 470.Cm UseLogin
463is enabled. 471is enabled.
@@ -578,6 +586,8 @@ These files are created using
578.Xr ssh-keygen 1 . 586.Xr ssh-keygen 1 .
579.It Pa /etc/moduli 587.It Pa /etc/moduli
580Contains Diffie-Hellman groups used for the "Diffie-Hellman Group Exchange". 588Contains Diffie-Hellman groups used for the "Diffie-Hellman Group Exchange".
589The file format is described in
590.Xr moduli 5 .
581.It Pa /var/empty 591.It Pa /var/empty
582.Xr chroot 2 592.Xr chroot 2
583directory used by 593directory used by
@@ -698,6 +708,10 @@ It can only contain empty lines, comment lines (that start with
698and assignment lines of the form name=value. 708and assignment lines of the form name=value.
699The file should be writable 709The file should be writable
700only by the user; it need not be readable by anyone else. 710only by the user; it need not be readable by anyone else.
711Environment processing is disabled by default and is
712controlled via the
713.Cm PermitUserEnvironment
714option.
701.It Pa $HOME/.ssh/rc 715.It Pa $HOME/.ssh/rc
702If this file exists, it is run with /bin/sh after reading the 716If this file exists, it is run with /bin/sh after reading the
703environment files but before starting the user's shell or command. 717environment files but before starting the user's shell or command.
@@ -723,12 +737,12 @@ something similar to:
723if read proto cookie && [ -n "$DISPLAY" ]; then 737if read proto cookie && [ -n "$DISPLAY" ]; then
724 if [ `echo $DISPLAY | cut -c1-10` = 'localhost:' ]; then 738 if [ `echo $DISPLAY | cut -c1-10` = 'localhost:' ]; then
725 # X11UseLocalhost=yes 739 # X11UseLocalhost=yes
726 xauth add unix:`echo $DISPLAY | 740 echo add unix:`echo $DISPLAY |
727 cut -c11-` $proto $cookie 741 cut -c11-` $proto $cookie
728 else 742 else
729 # X11UseLocalhost=no 743 # X11UseLocalhost=no
730 xauth add $DISPLAY $proto $cookie 744 echo add $DISPLAY $proto $cookie
731 fi 745 fi | xauth -q -
732fi 746fi
733.Ed 747.Ed
734.Pp 748.Pp