diff options
author | Damien Miller <djm@mindrot.org> | 2010-08-31 22:31:14 +1000 |
---|---|---|
committer | Damien Miller <djm@mindrot.org> | 2010-08-31 22:31:14 +1000 |
commit | afdae616354e19d2b420fd533ddc2099de4c404c (patch) | |
tree | cc3f87dd6f41b0228426563d5febd5723e21be27 /sshd.8 | |
parent | 6889abd9ad3cf0ec9a136b9ece71373c05087e38 (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.8 | 56 |
1 files changed, 28 insertions, 28 deletions
@@ -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 |
755 | This file is used to suppress printing the last login time and | 755 | This file is used to suppress printing the last login time and |
756 | .Pa /etc/motd , | 756 | .Pa /etc/motd , |
757 | if | 757 | if |
@@ -763,7 +763,7 @@ are enabled. | |||
763 | It does not suppress printing of the banner specified by | 763 | It 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 |
767 | This file is used for host-based authentication (see | 767 | This file is used for host-based authentication (see |
768 | .Xr ssh 1 | 768 | .Xr ssh 1 |
769 | for more information). | 769 | for more information). |
@@ -778,20 +778,20 @@ The recommended | |||
778 | permission for most machines is read/write for the user, and not | 778 | permission for most machines is read/write for the user, and not |
779 | accessible by others. | 779 | accessible by others. |
780 | .Pp | 780 | .Pp |
781 | .It ~/.shosts | 781 | .It Pa ~/.shosts |
782 | This file is used in exactly the same way as | 782 | This file is used in exactly the same way as |
783 | .Pa .rhosts , | 783 | .Pa .rhosts , |
784 | but allows host-based authentication without permitting login with | 784 | but allows host-based authentication without permitting login with |
785 | rlogin/rsh. | 785 | rlogin/rsh. |
786 | .Pp | 786 | .Pp |
787 | .It ~/.ssh/ | 787 | .It Pa ~/.ssh/ |
788 | This directory is the default location for all user-specific configuration | 788 | This directory is the default location for all user-specific configuration |
789 | and authentication information. | 789 | and authentication information. |
790 | There is no general requirement to keep the entire contents of this directory | 790 | There is no general requirement to keep the entire contents of this directory |
791 | secret, but the recommended permissions are read/write/execute for the user, | 791 | secret, but the recommended permissions are read/write/execute for the user, |
792 | and not accessible by others. | 792 | and not accessible by others. |
793 | .Pp | 793 | .Pp |
794 | .It ~/.ssh/authorized_keys | 794 | .It Pa ~/.ssh/authorized_keys |
795 | Lists the public keys (RSA/DSA) that can be used for logging in as this user. | 795 | Lists the public keys (RSA/DSA) that can be used for logging in as this user. |
796 | The format of this file is described above. | 796 | The format of this file is described above. |
797 | The content of the file is not highly sensitive, but the recommended | 797 | The content of the file is not highly sensitive, but the recommended |
@@ -809,7 +809,7 @@ will not allow it to be used unless the | |||
809 | option has been set to | 809 | option has been set to |
810 | .Dq no . | 810 | .Dq no . |
811 | .Pp | 811 | .Pp |
812 | .It ~/.ssh/environment | 812 | .It Pa ~/.ssh/environment |
813 | This file is read into the environment at login (if it exists). | 813 | This file is read into the environment at login (if it exists). |
814 | It can only contain empty lines, comment lines (that start with | 814 | It 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 |
822 | option. | 822 | option. |
823 | .Pp | 823 | .Pp |
824 | .It ~/.ssh/known_hosts | 824 | .It Pa ~/.ssh/known_hosts |
825 | Contains a list of host keys for all hosts the user has logged into | 825 | Contains a list of host keys for all hosts the user has logged into |
826 | that are not already in the systemwide list of known host keys. | 826 | that are not already in the systemwide list of known host keys. |
827 | The format of this file is described above. | 827 | The format of this file is described above. |
828 | This file should be writable only by root/the owner and | 828 | This file should be writable only by root/the owner and |
829 | can, but need not be, world-readable. | 829 | can, but need not be, world-readable. |
830 | .Pp | 830 | .Pp |
831 | .It ~/.ssh/rc | 831 | .It Pa ~/.ssh/rc |
832 | Contains initialization routines to be run before | 832 | Contains initialization routines to be run before |
833 | the user's home directory becomes accessible. | 833 | the user's home directory becomes accessible. |
834 | This file should be writable only by the user, and need not be | 834 | This file should be writable only by the user, and need not be |
835 | readable by anyone else. | 835 | readable 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 |
839 | Access controls that should be enforced by tcp-wrappers are defined here. | 839 | Access controls that should be enforced by tcp-wrappers are defined here. |
840 | Further details are described in | 840 | Further 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 |
844 | This file is for host-based authentication (see | 844 | This file is for host-based authentication (see |
845 | .Xr ssh 1 ) . | 845 | .Xr ssh 1 ) . |
846 | It should only be writable by root. | 846 | It should only be writable by root. |
847 | .Pp | 847 | .Pp |
848 | .It /etc/moduli | 848 | .It Pa /etc/moduli |
849 | Contains Diffie-Hellman groups used for the "Diffie-Hellman Group Exchange". | 849 | Contains Diffie-Hellman groups used for the "Diffie-Hellman Group Exchange". |
850 | The file format is described in | 850 | The 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 |
854 | See | 854 | See |
855 | .Xr motd 5 . | 855 | .Xr motd 5 . |
856 | .Pp | 856 | .Pp |
857 | .It /etc/nologin | 857 | .It Pa /etc/nologin |
858 | If this file exists, | 858 | If this file exists, |
859 | .Nm | 859 | .Nm |
860 | refuses to let anyone except root log in. | 860 | refuses to let anyone except root log in. |
@@ -863,15 +863,15 @@ are displayed to anyone trying to log in, and non-root connections are | |||
863 | refused. | 863 | refused. |
864 | The file should be world-readable. | 864 | The file should be world-readable. |
865 | .Pp | 865 | .Pp |
866 | .It /etc/shosts.equiv | 866 | .It Pa /etc/shosts.equiv |
867 | This file is used in exactly the same way as | 867 | This file is used in exactly the same way as |
868 | .Pa hosts.equiv , | 868 | .Pa hosts.equiv , |
869 | but allows host-based authentication without permitting login with | 869 | but allows host-based authentication without permitting login with |
870 | rlogin/rsh. | 870 | rlogin/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 |
875 | These three files contain the private parts of the host keys. | 875 | These three files contain the private parts of the host keys. |
876 | These files should only be owned by root, readable only by root, and not | 876 | These files should only be owned by root, readable only by root, and not |
877 | accessible to others. | 877 | accessible to others. |
@@ -879,9 +879,9 @@ Note that | |||
879 | .Nm | 879 | .Nm |
880 | does not start if these files are group/world-accessible. | 880 | does 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 |
885 | These three files contain the public parts of the host keys. | 885 | These three files contain the public parts of the host keys. |
886 | These files should be world-readable but writable only by | 886 | These files should be world-readable but writable only by |
887 | root. | 887 | root. |
@@ -892,7 +892,7 @@ the user so their contents can be copied to known hosts files. | |||
892 | These files are created using | 892 | These 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 |
896 | Systemwide list of known host keys. | 896 | Systemwide list of known host keys. |
897 | This file should be prepared by the | 897 | This file should be prepared by the |
898 | system administrator to contain the public host keys of all machines in the | 898 | system administrator to contain the public host keys of all machines in the |
@@ -901,20 +901,20 @@ The format of this file is described above. | |||
901 | This file should be writable only by root/the owner and | 901 | This file should be writable only by root/the owner and |
902 | should be world-readable. | 902 | should be world-readable. |
903 | .Pp | 903 | .Pp |
904 | .It /etc/ssh/sshd_config | 904 | .It Pa /etc/ssh/sshd_config |
905 | Contains configuration data for | 905 | Contains configuration data for |
906 | .Nm sshd . | 906 | .Nm sshd . |
907 | The file format and configuration options are described in | 907 | The 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 |
911 | Similar to | 911 | Similar to |
912 | .Pa ~/.ssh/rc , | 912 | .Pa ~/.ssh/rc , |
913 | it can be used to specify | 913 | it can be used to specify |
914 | machine-specific login-time initializations globally. | 914 | machine-specific login-time initializations globally. |
915 | This file should be writable only by root, and should be world-readable. | 915 | This 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 |
919 | directory used by | 919 | directory used by |
920 | .Nm | 920 | .Nm |
@@ -922,7 +922,7 @@ during privilege separation in the pre-authentication phase. | |||
922 | The directory should not contain any files and must be owned by root | 922 | The directory should not contain any files and must be owned by root |
923 | and not group or world-writable. | 923 | and not group or world-writable. |
924 | .Pp | 924 | .Pp |
925 | .It /var/run/sshd.pid | 925 | .It Pa /var/run/sshd.pid |
926 | Contains the process ID of the | 926 | Contains the process ID of the |
927 | .Nm | 927 | .Nm |
928 | listening for connections (if there are several daemons running | 928 | listening for connections (if there are several daemons running |