1180740SdesThis package describes important Cygwin specific stuff concerning OpenSSH. 2180740Sdes 3180740SdesThe binary package is usually built for recent Cygwin versions and might 4180740Sdesnot run on older versions. Please check http://cygwin.com/ for information 5180740Sdesabout current Cygwin releases. 6180740Sdes 7255670Sdes================== 8255670SdesHost configuration 9255670Sdes================== 10180740Sdes 11180740SdesIf you are installing OpenSSH the first time, you can generate global config 12255670Sdesfiles and server keys, as well as installing sshd as a service, by running 13180740Sdes 14180740Sdes /usr/bin/ssh-host-config 15180740Sdes 16180740SdesNote that this binary archive doesn't contain default config files in /etc. 17180740SdesThat files are only created if ssh-host-config is started. 18180740Sdes 19180740SdesTo support testing and unattended installation ssh-host-config got 20180740Sdessome options: 21180740Sdes 22180740Sdesusage: ssh-host-config [OPTION]... 23180740SdesOptions: 24180740Sdes --debug -d Enable shell's debug output. 25180740Sdes --yes -y Answer all questions with "yes" automatically. 26180740Sdes --no -n Answer all questions with "no" automatically. 27180740Sdes --cygwin -c <options> Use "options" as value for CYGWIN environment var. 28180740Sdes --port -p <n> sshd listens on port n. 29255670Sdes --user -u <account> privileged user for service, default 'cyg_server'. 30255670Sdes --pwd -w <passwd> Use "pwd" as password for privileged user. 31255670Sdes --privileged On Windows XP, require privileged user 32255670Sdes instead of LocalSystem for sshd service. 33180740Sdes 34255670SdesInstalling sshd as daemon via ssh-host-config is recommended. 35180740Sdes 36255670SdesAlternatively you can start sshd via inetd, if you have the inetutils 37255670Sdespackage installed. Just run ssh-host-config, but answer "no" when asked 38255670Sdesto install sshd as service. The ssh-host-config script also adds the 39255670Sdesrequired lines to /etc/inetd.conf and /etc/services. 40180740Sdes 41255670Sdes================== 42255670SdesUser configuration 43255670Sdes================== 44255670Sdes 45255670SdesAny user can simplify creating the own private and public keys by running 46255670Sdes 47180740Sdes /usr/bin/ssh-user-config 48180740Sdes 49180740SdesTo support testing and unattended installation ssh-user-config got 50180740Sdessome options as well: 51180740Sdes 52180740Sdesusage: ssh-user-config [OPTION]... 53180740SdesOptions: 54180740Sdes --debug -d Enable shell's debug output. 55180740Sdes --yes -y Answer all questions with "yes" automatically. 56180740Sdes --no -n Answer all questions with "no" automatically. 57180740Sdes --passphrase -p word Use "word" as passphrase automatically. 58180740Sdes 59180740SdesPlease note that OpenSSH does never use the value of $HOME to 60180740Sdessearch for the users configuration files! It always uses the 61180740Sdesvalue of the pw_dir field in /etc/passwd as the home directory. 62180740SdesIf no home diretory is set in /etc/passwd, the root directory 63180740Sdesis used instead! 64180740Sdes 65255670Sdes================ 66255670SdesBuilding OpenSSH 67255670Sdes================ 68180740Sdes 69255670SdesBuilding from source is easy. Just unpack the source archive, cd to that 70255670Sdesdirectory, and call cygport: 71180740Sdes 72255670Sdes cygport openssh.cygport almostall 73180740Sdes 74255670SdesYou must have installed the following packages to be able to build OpenSSH 75255670Sdeswith the aforementioned cygport script: 76180740Sdes 77255670Sdes zlib 78255670Sdes crypt 79255670Sdes openssl-devel 80255670Sdes libwrap-devel 81255670Sdes libedit-devel 82255670Sdes libkrb5-devel 83180740Sdes 84180740SdesPlease send requests, error reports etc. to cygwin@cygwin.com. 85180740Sdes 86180740Sdes 87180740SdesHave fun, 88180740Sdes 89180740SdesCorinna Vinschen 90180740SdesCygwin Developer 91180740SdesRed Hat Inc. 92