crypto/openssh/contrib/cygwin/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@cygwin.com.
  85
  86
  87 Have fun,
  88
  89 Corinna Vinschen
  90 Cygwin Developer
  91 Red Hat Inc.