diff options
author | Damien Miller <djm@mindrot.org> | 1999-11-12 14:35:58 +1100 |
---|---|---|
committer | Damien Miller <djm@mindrot.org> | 1999-11-12 14:35:58 +1100 |
commit | b5f8927a7e3f25cef4c66603a780176e1b9f6082 (patch) | |
tree | 49458673c712033da7f667cace14438057d276b7 | |
parent | a419528432c5dc7d963288949da97d34b36348b0 (diff) |
Added INSTALL documentation
Minor other doc updates
-rw-r--r-- | ChangeLog | 2 | ||||
-rw-r--r-- | INSTALL | 86 | ||||
-rw-r--r-- | README | 10 | ||||
-rw-r--r-- | TODO | 4 |
4 files changed, 93 insertions, 9 deletions
@@ -8,6 +8,8 @@ | |||
8 | - Grab server in gnome-ssh-askpass (Debian bug #49872) | 8 | - Grab server in gnome-ssh-askpass (Debian bug #49872) |
9 | - Released 1.2pre10 | 9 | - Released 1.2pre10 |
10 | 10 | ||
11 | - Added INSTALL documentation | ||
12 | |||
11 | 19991111 | 13 | 19991111 |
12 | - Added (untested) Entropy Gathering Daemon (EGD) support | 14 | - Added (untested) Entropy Gathering Daemon (EGD) support |
13 | - Fixed /dev/urandom fd leak (Debian bug #49722) | 15 | - Fixed /dev/urandom fd leak (Debian bug #49722) |
diff --git a/INSTALL b/INSTALL new file mode 100644 index 000000000..54d48e25c --- /dev/null +++ b/INSTALL | |||
@@ -0,0 +1,86 @@ | |||
1 | 1. Prerequisites | ||
2 | ---------------- | ||
3 | |||
4 | You will need working installations of Zlib and OpenSSL. | ||
5 | |||
6 | Zlib: | ||
7 | http://www.cdrom.com/pub/infozip/zlib/ | ||
8 | |||
9 | OpenSSL: | ||
10 | http://www.openssl.org/ | ||
11 | |||
12 | OpenSSH can utilise Pluggable Authentication Modules (PAM) if your system | ||
13 | supports it. PAM is standard on Redhat and Debian Linux and on Solaris. | ||
14 | |||
15 | PAM: | ||
16 | http://www.kernel.org/pub/linux/libs/pam/ | ||
17 | |||
18 | If you wish to build the GNOME passphrase requestor, you will need the GNOME | ||
19 | libraries and headers. | ||
20 | |||
21 | GNOME: | ||
22 | http://www.gnome.org/ | ||
23 | |||
24 | If you are planning to use OpenSSH on a Unix which lacks a Kernel random | ||
25 | number generator (/dev/urandom), you will need to install the Entropy | ||
26 | Gathering Daemon (or similar). You will also need to specify the | ||
27 | --with-egd-pool option to ./configure. | ||
28 | |||
29 | EGD: | ||
30 | http://www.lothar.com/tech/crypto/ | ||
31 | |||
32 | |||
33 | 2. Building / Installation | ||
34 | -------------------------- | ||
35 | |||
36 | To install OpenSSH with default options: | ||
37 | |||
38 | ./configure | ||
39 | make | ||
40 | make install | ||
41 | |||
42 | This will install the OpenSSH binaries in /usr/local/bin, configuration files | ||
43 | in /usr/local/etc, the server in /usr/local/sbin, etc. To specify a different | ||
44 | installation prefix, use the --prefix option to configure: | ||
45 | |||
46 | ./configure --prefix=/opt | ||
47 | make | ||
48 | make install | ||
49 | |||
50 | Will install OpenSSH in /opt/{bin,etc,lib,sbin}. You can also override | ||
51 | specific paths, for example: | ||
52 | |||
53 | ./configure --prefix=/opt --sysconfdir=/etc/ssh | ||
54 | make | ||
55 | make install | ||
56 | |||
57 | This will install the binaries in /opt/{bin,lib,sbin}, but will place the | ||
58 | configuration files in /etc/ssh. | ||
59 | |||
60 | There are a few other options to the configure script: | ||
61 | |||
62 | --enable-gnome-askpass will build the GNOME passphrase dialog. You need a | ||
63 | working installation of GNOME, including the development headers, for this | ||
64 | to work. | ||
65 | |||
66 | --with-random=/some/file allows you to specify an alternate source of | ||
67 | random numbers (the default is /dev/urandom). Unless you are absolutly | ||
68 | sure of what you are doing, it is best to leave this alone. | ||
69 | |||
70 | --with-egd-pool=/some/file allows you to enable Entropy Gathering Daemon | ||
71 | support and to specify a EGD pool socket. You will need to use this if your | ||
72 | Unix does not support the /dev/urandom device (or similar). | ||
73 | |||
74 | |||
75 | 3. Configuration | ||
76 | ---------------- | ||
77 | |||
78 | The runtime configuration files are installed by in ${prefix}/etc or | ||
79 | whatever you specified as your --sysconfdir (/usr/local/etc by default). | ||
80 | |||
81 | The default configuration should be instantly usable, though you should | ||
82 | review it to ensure that it matches your security requirements. | ||
83 | |||
84 | For more information on configuration, please refer to the manual pages | ||
85 | for sshd, ssh and ssh-agent. | ||
86 | |||
@@ -32,14 +32,8 @@ send a message conststing of the word 'SUBSCRIBE' to | |||
32 | openssh-unix-dev-request@mindrot.org. This mailing list is intended for | 32 | openssh-unix-dev-request@mindrot.org. This mailing list is intended for |
33 | developers. | 33 | developers. |
34 | 34 | ||
35 | To build OpenSSH, use the configure script provided. For example: | 35 | Please refer to the INSTALL document for information on how to install |
36 | 36 | OpenSSH on your system. | |
37 | ./configure --prefix=/opt/openssh | ||
38 | make | ||
39 | make install | ||
40 | |||
41 | Will install the OpenSSH binaries in /opt/openssh/bin, the | ||
42 | configuration files in /opt/openssh/etc, and so forth. | ||
43 | 37 | ||
44 | Damien Miller <djm@ibs.com.au> | 38 | Damien Miller <djm@ibs.com.au> |
45 | Internet Business Solutions | 39 | Internet Business Solutions |
@@ -4,8 +4,10 @@ | |||
4 | 4 | ||
5 | - Better documentation | 5 | - Better documentation |
6 | 6 | ||
7 | - Port to other platforms | 7 | - Port to other platforms (Finish Solaris support) |
8 | 8 | ||
9 | - Fix paths in manpages using autoconf | 9 | - Fix paths in manpages using autoconf |
10 | 10 | ||
11 | - Enable libwrap support using autoconf switch | 11 | - Enable libwrap support using autoconf switch |
12 | |||
13 | - Better testing on non-PAM systems | ||