README
1 This package describes important Cygwin specific stuff concerning OpenSSH.
2
3 The binary package is usually built for recent Cygwin versions and might
4 not run on older versions. Please check http://cygwin.com/ for information
5 about current Cygwin releases.
6
7 ==================
8 Host configuration
9 ==================
10
11 If you are installing OpenSSH the first time, you can generate global config
12 files and server keys, as well as installing sshd as a service, by running
13
14 /usr/bin/ssh-host-config
15
16 Note that this binary archive doesn't contain default config files in /etc.
17 That files are only created if ssh-host-config is started.
18
19 To support testing and unattended installation ssh-host-config got
20 some options:
21
22 usage: ssh-host-config [OPTION]...
23 Options:
24 --debug -d Enable shell's debug output.
25 --yes -y Answer all questions with "yes" automatically.
26 --no -n Answer all questions with "no" automatically.
27 --cygwin -c <options> Use "options" as value for CYGWIN environment var.
28 --name -N <name> sshd windows service name.
29 --port -p <n> sshd listens on port n.
30 --user -u <account> privileged user for service, default 'cyg_server'.
31 --pwd -w <passwd> Use "pwd" as password for privileged user.
32 --privileged On Windows XP, require privileged user
33 instead of LocalSystem for sshd service.
34
35 Installing sshd as daemon via ssh-host-config is recommended.
36
37 Alternatively you can start sshd via inetd, if you have the inetutils
38 package installed. Just run ssh-host-config, but answer "no" when asked
39 to install sshd as service. The ssh-host-config script also adds the
40 required lines to /etc/inetd.conf and /etc/services.
41
42 ==================
43 User configuration
44 ==================
45
46 Any user can simplify creating the own private and public keys by running
47
48 /usr/bin/ssh-user-config
49
50 To support testing and unattended installation ssh-user-config got
51 some options as well:
52
53 usage: ssh-user-config [OPTION]...
54 Options:
55 --debug -d Enable shell's debug output.
56 --yes -y Answer all questions with "yes" automatically.
57 --no -n Answer all questions with "no" automatically.
58 --passphrase -p word Use "word" as passphrase automatically.
59
60 Please note that OpenSSH does never use the value of $HOME to
61 search for the users configuration files! It always uses the
62 value of the pw_dir field in /etc/passwd as the home directory.
63 If no home diretory is set in /etc/passwd, the root directory
64 is used instead!
65
66 ================
67 Building OpenSSH
68 ================
69
70 Building from source is easy. Just unpack the source archive, cd to that
71 directory, and call cygport:
72
73 cygport openssh.cygport all
74
75 You must have installed the following packages to be able to build OpenSSH
76 with the aforementioned cygport script:
77
78 zlib
79 crypt
80 openssl-devel
81 libedit-devel
82 libkrb5-devel
83
84 Please send requests, error reports etc. to cygwin (a] cygwin.com.
85
86
87 Have fun,
88
89 Corinna Vinschen
90 Cygwin Developer
91 Red Hat Inc.
92