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. 28323124Sdes --name -N <name> sshd windows service name. 29180740Sdes --port -p <n> sshd listens on port n. 30255670Sdes --user -u <account> privileged user for service, default 'cyg_server'. 31255670Sdes --pwd -w <passwd> Use "pwd" as password for privileged user. 32255670Sdes --privileged On Windows XP, require privileged user 33255670Sdes instead of LocalSystem for sshd service. 34180740Sdes 35255670SdesInstalling sshd as daemon via ssh-host-config is recommended. 36180740Sdes 37255670SdesAlternatively you can start sshd via inetd, if you have the inetutils 38255670Sdespackage installed. Just run ssh-host-config, but answer "no" when asked 39255670Sdesto install sshd as service. The ssh-host-config script also adds the 40255670Sdesrequired lines to /etc/inetd.conf and /etc/services. 41180740Sdes 42255670Sdes================== 43255670SdesUser configuration 44255670Sdes================== 45255670Sdes 46255670SdesAny user can simplify creating the own private and public keys by running 47255670Sdes 48180740Sdes /usr/bin/ssh-user-config 49180740Sdes 50180740SdesTo support testing and unattended installation ssh-user-config got 51180740Sdessome options as well: 52180740Sdes 53180740Sdesusage: ssh-user-config [OPTION]... 54180740SdesOptions: 55180740Sdes --debug -d Enable shell's debug output. 56180740Sdes --yes -y Answer all questions with "yes" automatically. 57180740Sdes --no -n Answer all questions with "no" automatically. 58180740Sdes --passphrase -p word Use "word" as passphrase automatically. 59180740Sdes 60180740SdesPlease note that OpenSSH does never use the value of $HOME to 61180740Sdessearch for the users configuration files! It always uses the 62180740Sdesvalue of the pw_dir field in /etc/passwd as the home directory. 63180740SdesIf no home diretory is set in /etc/passwd, the root directory 64180740Sdesis used instead! 65180740Sdes 66255670Sdes================ 67255670SdesBuilding OpenSSH 68255670Sdes================ 69180740Sdes 70255670SdesBuilding from source is easy. Just unpack the source archive, cd to that 71255670Sdesdirectory, and call cygport: 72180740Sdes 73295367Sdes cygport openssh.cygport all 74180740Sdes 75255670SdesYou must have installed the following packages to be able to build OpenSSH 76255670Sdeswith the aforementioned cygport script: 77180740Sdes 78255670Sdes zlib 79255670Sdes crypt 80255670Sdes openssl-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