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