summaryrefslogtreecommitdiff
path: root/sshd.8
diff options
context:
space:
mode:
authorDamien Miller <djm@mindrot.org>2010-08-31 22:31:14 +1000
committerDamien Miller <djm@mindrot.org>2010-08-31 22:31:14 +1000
commitafdae616354e19d2b420fd533ddc2099de4c404c (patch)
treecc3f87dd6f41b0228426563d5febd5723e21be27 /sshd.8
parent6889abd9ad3cf0ec9a136b9ece71373c05087e38 (diff)
- jmc@cvs.openbsd.org 2010/08/08 19:36:30
[ssh-keysign.8 ssh.1 sshd.8] use the same template for all FILES sections; i.e. -compact/.Pp where we have multiple items, and .Pa for path names;
Diffstat (limited to 'sshd.8')
-rw-r--r--sshd.856
1 files changed, 28 insertions, 28 deletions
diff --git a/sshd.8 b/sshd.8
index d3685b92b..bf9d6a2ec 100644
--- a/sshd.8
+++ b/sshd.8
@@ -34,8 +34,8 @@
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.257 2010/08/04 05:37:01 djm Exp $ 37.\" $OpenBSD: sshd.8,v 1.258 2010/08/08 19:36:30 jmc Exp $
38.Dd $Mdocdate: August 4 2010 $ 38.Dd $Mdocdate: August 8 2010 $
39.Dt SSHD 8 39.Dt SSHD 8
40.Os 40.Os
41.Sh NAME 41.Sh NAME
@@ -751,7 +751,7 @@ AAAA1234.....=
751.Ed 751.Ed
752.Sh FILES 752.Sh FILES
753.Bl -tag -width Ds -compact 753.Bl -tag -width Ds -compact
754.It ~/.hushlogin 754.It Pa ~/.hushlogin
755This file is used to suppress printing the last login time and 755This file is used to suppress printing the last login time and
756.Pa /etc/motd , 756.Pa /etc/motd ,
757if 757if
@@ -763,7 +763,7 @@ are enabled.
763It does not suppress printing of the banner specified by 763It does not suppress printing of the banner specified by
764.Cm Banner . 764.Cm Banner .
765.Pp 765.Pp
766.It ~/.rhosts 766.It Pa ~/.rhosts
767This file is used for host-based authentication (see 767This file is used for host-based authentication (see
768.Xr ssh 1 768.Xr ssh 1
769for more information). 769for more information).
@@ -778,20 +778,20 @@ The recommended
778permission for most machines is read/write for the user, and not 778permission for most machines is read/write for the user, and not
779accessible by others. 779accessible by others.
780.Pp 780.Pp
781.It ~/.shosts 781.It Pa ~/.shosts
782This file is used in exactly the same way as 782This file is used in exactly the same way as
783.Pa .rhosts , 783.Pa .rhosts ,
784but allows host-based authentication without permitting login with 784but allows host-based authentication without permitting login with
785rlogin/rsh. 785rlogin/rsh.
786.Pp 786.Pp
787.It ~/.ssh/ 787.It Pa ~/.ssh/
788This directory is the default location for all user-specific configuration 788This directory is the default location for all user-specific configuration
789and authentication information. 789and authentication information.
790There is no general requirement to keep the entire contents of this directory 790There is no general requirement to keep the entire contents of this directory
791secret, but the recommended permissions are read/write/execute for the user, 791secret, but the recommended permissions are read/write/execute for the user,
792and not accessible by others. 792and not accessible by others.
793.Pp 793.Pp
794.It ~/.ssh/authorized_keys 794.It Pa ~/.ssh/authorized_keys
795Lists the public keys (RSA/DSA) that can be used for logging in as this user. 795Lists the public keys (RSA/DSA) that can be used for logging in as this user.
796The format of this file is described above. 796The format of this file is described above.
797The content of the file is not highly sensitive, but the recommended 797The content of the file is not highly sensitive, but the recommended
@@ -809,7 +809,7 @@ will not allow it to be used unless the
809option has been set to 809option has been set to
810.Dq no . 810.Dq no .
811.Pp 811.Pp
812.It ~/.ssh/environment 812.It Pa ~/.ssh/environment
813This file is read into the environment at login (if it exists). 813This file is read into the environment at login (if it exists).
814It can only contain empty lines, comment lines (that start with 814It can only contain empty lines, comment lines (that start with
815.Ql # ) , 815.Ql # ) ,
@@ -821,40 +821,40 @@ controlled via the
821.Cm PermitUserEnvironment 821.Cm PermitUserEnvironment
822option. 822option.
823.Pp 823.Pp
824.It ~/.ssh/known_hosts 824.It Pa ~/.ssh/known_hosts
825Contains a list of host keys for all hosts the user has logged into 825Contains a list of host keys for all hosts the user has logged into
826that are not already in the systemwide list of known host keys. 826that are not already in the systemwide list of known host keys.
827The format of this file is described above. 827The format of this file is described above.
828This file should be writable only by root/the owner and 828This file should be writable only by root/the owner and
829can, but need not be, world-readable. 829can, but need not be, world-readable.
830.Pp 830.Pp
831.It ~/.ssh/rc 831.It Pa ~/.ssh/rc
832Contains initialization routines to be run before 832Contains initialization routines to be run before
833the user's home directory becomes accessible. 833the user's home directory becomes accessible.
834This file should be writable only by the user, and need not be 834This file should be writable only by the user, and need not be
835readable by anyone else. 835readable by anyone else.
836.Pp 836.Pp
837.It /etc/hosts.allow 837.It Pa /etc/hosts.allow
838.It /etc/hosts.deny 838.It Pa /etc/hosts.deny
839Access controls that should be enforced by tcp-wrappers are defined here. 839Access controls that should be enforced by tcp-wrappers are defined here.
840Further details are described in 840Further details are described in
841.Xr hosts_access 5 . 841.Xr hosts_access 5 .
842.Pp 842.Pp
843.It /etc/hosts.equiv 843.It Pa /etc/hosts.equiv
844This file is for host-based authentication (see 844This file is for host-based authentication (see
845.Xr ssh 1 ) . 845.Xr ssh 1 ) .
846It should only be writable by root. 846It should only be writable by root.
847.Pp 847.Pp
848.It /etc/moduli 848.It Pa /etc/moduli
849Contains Diffie-Hellman groups used for the "Diffie-Hellman Group Exchange". 849Contains Diffie-Hellman groups used for the "Diffie-Hellman Group Exchange".
850The file format is described in 850The file format is described in
851.Xr moduli 5 . 851.Xr moduli 5 .
852.Pp 852.Pp
853.It /etc/motd 853.It Pa /etc/motd
854See 854See
855.Xr motd 5 . 855.Xr motd 5 .
856.Pp 856.Pp
857.It /etc/nologin 857.It Pa /etc/nologin
858If this file exists, 858If this file exists,
859.Nm 859.Nm
860refuses to let anyone except root log in. 860refuses to let anyone except root log in.
@@ -863,15 +863,15 @@ are displayed to anyone trying to log in, and non-root connections are
863refused. 863refused.
864The file should be world-readable. 864The file should be world-readable.
865.Pp 865.Pp
866.It /etc/shosts.equiv 866.It Pa /etc/shosts.equiv
867This file is used in exactly the same way as 867This file is used in exactly the same way as
868.Pa hosts.equiv , 868.Pa hosts.equiv ,
869but allows host-based authentication without permitting login with 869but allows host-based authentication without permitting login with
870rlogin/rsh. 870rlogin/rsh.
871.Pp 871.Pp
872.It /etc/ssh/ssh_host_key 872.It Pa /etc/ssh/ssh_host_key
873.It /etc/ssh/ssh_host_dsa_key 873.It Pa /etc/ssh/ssh_host_dsa_key
874.It /etc/ssh/ssh_host_rsa_key 874.It Pa /etc/ssh/ssh_host_rsa_key
875These three files contain the private parts of the host keys. 875These three files contain the private parts of the host keys.
876These files should only be owned by root, readable only by root, and not 876These files should only be owned by root, readable only by root, and not
877accessible to others. 877accessible to others.
@@ -879,9 +879,9 @@ Note that
879.Nm 879.Nm
880does not start if these files are group/world-accessible. 880does not start if these files are group/world-accessible.
881.Pp 881.Pp
882.It /etc/ssh/ssh_host_key.pub 882.It Pa /etc/ssh/ssh_host_key.pub
883.It /etc/ssh/ssh_host_dsa_key.pub 883.It Pa /etc/ssh/ssh_host_dsa_key.pub
884.It /etc/ssh/ssh_host_rsa_key.pub 884.It Pa /etc/ssh/ssh_host_rsa_key.pub
885These three files contain the public parts of the host keys. 885These three files contain the public parts of the host keys.
886These files should be world-readable but writable only by 886These files should be world-readable but writable only by
887root. 887root.
@@ -892,7 +892,7 @@ the user so their contents can be copied to known hosts files.
892These files are created using 892These files are created using
893.Xr ssh-keygen 1 . 893.Xr ssh-keygen 1 .
894.Pp 894.Pp
895.It /etc/ssh/ssh_known_hosts 895.It Pa /etc/ssh/ssh_known_hosts
896Systemwide list of known host keys. 896Systemwide list of known host keys.
897This file should be prepared by the 897This file should be prepared by the
898system administrator to contain the public host keys of all machines in the 898system administrator to contain the public host keys of all machines in the
@@ -901,20 +901,20 @@ The format of this file is described above.
901This file should be writable only by root/the owner and 901This file should be writable only by root/the owner and
902should be world-readable. 902should be world-readable.
903.Pp 903.Pp
904.It /etc/ssh/sshd_config 904.It Pa /etc/ssh/sshd_config
905Contains configuration data for 905Contains configuration data for
906.Nm sshd . 906.Nm sshd .
907The file format and configuration options are described in 907The file format and configuration options are described in
908.Xr sshd_config 5 . 908.Xr sshd_config 5 .
909.Pp 909.Pp
910.It /etc/ssh/sshrc 910.It Pa /etc/ssh/sshrc
911Similar to 911Similar to
912.Pa ~/.ssh/rc , 912.Pa ~/.ssh/rc ,
913it can be used to specify 913it can be used to specify
914machine-specific login-time initializations globally. 914machine-specific login-time initializations globally.
915This file should be writable only by root, and should be world-readable. 915This file should be writable only by root, and should be world-readable.
916.Pp 916.Pp
917.It /var/empty 917.It Pa /var/empty
918.Xr chroot 2 918.Xr chroot 2
919directory used by 919directory used by
920.Nm 920.Nm
@@ -922,7 +922,7 @@ during privilege separation in the pre-authentication phase.
922The directory should not contain any files and must be owned by root 922The directory should not contain any files and must be owned by root
923and not group or world-writable. 923and not group or world-writable.
924.Pp 924.Pp
925.It /var/run/sshd.pid 925.It Pa /var/run/sshd.pid
926Contains the process ID of the 926Contains the process ID of the
927.Nm 927.Nm
928listening for connections (if there are several daemons running 928listening for connections (if there are several daemons running