summaryrefslogtreecommitdiff
path: root/sshd.8
diff options
context:
space:
mode:
authorColin Watson <cjwatson@debian.org>2003-09-01 02:05:26 +0000
committerColin Watson <cjwatson@debian.org>2003-09-01 02:05:26 +0000
commit6d5a72bc1d98a42ba42f082e50a22e911c1d82d3 (patch)
tree1bf23174bdb6fc71e2846dda0eca195a418484e7 /sshd.8
parent2ee26b431f98cf1dc0e4fb9809ad1e0c879b8c08 (diff)
parent58657d96514cd6f16d82add8d6f4adbb36765758 (diff)
Debian release 3.5p1-1.
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 99fd6a131..1605922fb 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.
@@ -353,7 +353,11 @@ Sets up basic environment.
353.It 353.It
354Reads 354Reads
355.Pa $HOME/.ssh/environment 355.Pa $HOME/.ssh/environment
356if it exists. 356if it exists and users are allowed to change their environment.
357See the
358.Cm PermitUserEnvironment
359option in
360.Xr sshd_config 5 .
357.It 361.It
358Changes to user's home directory. 362Changes to user's home directory.
359.It 363.It
@@ -388,9 +392,9 @@ Each RSA public key consists of the following fields, separated by
388spaces: options, bits, exponent, modulus, comment. 392spaces: options, bits, exponent, modulus, comment.
389Each protocol version 2 public key consists of: 393Each protocol version 2 public key consists of:
390options, keytype, base64 encoded key, comment. 394options, keytype, base64 encoded key, comment.
391The options fields 395The options field
392are optional; its presence is determined by whether the line starts 396is optional; its presence is determined by whether the line starts
393with a number or not (the option field never starts with a number). 397with a number or not (the options field never starts with a number).
394The bits, exponent, modulus and comment fields give the RSA key for 398The bits, exponent, modulus and comment fields give the RSA key for
395protocol version 1; the 399protocol version 1; the
396comment field is not used for anything (but may be convenient for the 400comment field is not used for anything (but may be convenient for the
@@ -401,7 +405,7 @@ or
401.Dq ssh-rsa . 405.Dq ssh-rsa .
402.Pp 406.Pp
403Note that lines in this file are usually several hundred bytes long 407Note that lines in this file are usually several hundred bytes long
404(because of the size of the RSA key modulus). 408(because of the size of the public key encoding).
405You don't want to type them in; instead, copy the 409You don't want to type them in; instead, copy the
406.Pa identity.pub , 410.Pa identity.pub ,
407.Pa id_dsa.pub 411.Pa id_dsa.pub
@@ -420,7 +424,7 @@ The following option specifications are supported (note
420that option keywords are case-insensitive): 424that option keywords are case-insensitive):
421.Bl -tag -width Ds 425.Bl -tag -width Ds
422.It Cm from="pattern-list" 426.It Cm from="pattern-list"
423Specifies that in addition to RSA authentication, the canonical name 427Specifies that in addition to public key authentication, the canonical name
424of the remote host must be present in the comma-separated list of 428of the remote host must be present in the comma-separated list of
425patterns 429patterns
426.Pf ( Ql * 430.Pf ( Ql *
@@ -432,7 +436,7 @@ patterns negated by prefixing them with
432.Ql ! ; 436.Ql ! ;
433if the canonical host name matches a negated pattern, the key is not accepted. 437if the canonical host name matches a negated pattern, the key is not accepted.
434The purpose 438The purpose
435of this option is to optionally increase security: RSA authentication 439of this option is to optionally increase security: public key authentication
436by itself does not trust the network or name servers or anything (but 440by itself does not trust the network or name servers or anything (but
437the key); however, if somebody somehow steals the key, the key 441the key); however, if somebody somehow steals the key, the key
438permits an intruder to log in from anywhere in the world. 442permits an intruder to log in from anywhere in the world.
@@ -450,7 +454,7 @@ one must not request a pty or should specify
450.Cm no-pty . 454.Cm no-pty .
451A quote may be included in the command by quoting it with a backslash. 455A quote may be included in the command by quoting it with a backslash.
452This option might be useful 456This option might be useful
453to restrict certain RSA keys to perform just a specific operation. 457to restrict certain public keys to perform just a specific operation.
454An example might be a key that permits remote backups but nothing else. 458An example might be a key that permits remote backups but nothing else.
455Note that the client may specify TCP/IP and/or X11 459Note that the client may specify TCP/IP and/or X11
456forwarding unless they are explicitly prohibited. 460forwarding unless they are explicitly prohibited.
@@ -461,6 +465,10 @@ logging in using this key.
461Environment variables set this way 465Environment variables set this way
462override other default environment values. 466override other default environment values.
463Multiple options of this type are permitted. 467Multiple options of this type are permitted.
468Environment processing is disabled by default and is
469controlled via the
470.Cm PermitUserEnvironment
471option.
464This option is automatically disabled if 472This option is automatically disabled if
465.Cm UseLogin 473.Cm UseLogin
466is enabled. 474is enabled.
@@ -581,6 +589,8 @@ These files are created using
581.Xr ssh-keygen 1 . 589.Xr ssh-keygen 1 .
582.It Pa /etc/moduli 590.It Pa /etc/moduli
583Contains Diffie-Hellman groups used for the "Diffie-Hellman Group Exchange". 591Contains Diffie-Hellman groups used for the "Diffie-Hellman Group Exchange".
592The file format is described in
593.Xr moduli 5 .
584.It Pa /var/empty 594.It Pa /var/empty
585.Xr chroot 2 595.Xr chroot 2
586directory used by 596directory used by
@@ -701,6 +711,10 @@ It can only contain empty lines, comment lines (that start with
701and assignment lines of the form name=value. 711and assignment lines of the form name=value.
702The file should be writable 712The file should be writable
703only by the user; it need not be readable by anyone else. 713only by the user; it need not be readable by anyone else.
714Environment processing is disabled by default and is
715controlled via the
716.Cm PermitUserEnvironment
717option.
704.It Pa $HOME/.ssh/rc 718.It Pa $HOME/.ssh/rc
705If this file exists, it is run with /bin/sh after reading the 719If this file exists, it is run with /bin/sh after reading the
706environment files but before starting the user's shell or command. 720environment files but before starting the user's shell or command.
@@ -726,12 +740,12 @@ something similar to:
726if read proto cookie && [ -n "$DISPLAY" ]; then 740if read proto cookie && [ -n "$DISPLAY" ]; then
727 if [ `echo $DISPLAY | cut -c1-10` = 'localhost:' ]; then 741 if [ `echo $DISPLAY | cut -c1-10` = 'localhost:' ]; then
728 # X11UseLocalhost=yes 742 # X11UseLocalhost=yes
729 xauth add unix:`echo $DISPLAY | 743 echo add unix:`echo $DISPLAY |
730 cut -c11-` $proto $cookie 744 cut -c11-` $proto $cookie
731 else 745 else
732 # X11UseLocalhost=no 746 # X11UseLocalhost=no
733 xauth add $DISPLAY $proto $cookie 747 echo add $DISPLAY $proto $cookie
734 fi 748 fi | xauth -q -
735fi 749fi
736.Ed 750.Ed
737.Pp 751.Pp