1This file contains notes about OpenSSH on specific platforms. 2 3AIX 4--- 5As of OpenSSH 3.8p1, sshd will now honour an accounts password expiry 6settings, where previously it did not. Because of this, it's possible for 7sites that have used OpenSSH's sshd exclusively to have accounts which 8have passwords expired longer than the inactive time (ie the "Weeks between 9password EXPIRATION and LOCKOUT" setting in SMIT or the maxexpired 10chuser attribute). 11 12Accounts in this state must have their passwords reset manually by the 13administrator. As a precaution, it is recommended that the administrative 14passwords be reset before upgrading from OpenSSH <3.8. 15 16As of OpenSSH 4.0, configure will attempt to detect if your version 17and maintenance level of AIX has a working getaddrinfo, and will use it 18if found. This will enable IPv6 support. If for some reason configure 19gets it wrong, or if you want to build binaries to work on earlier MLs 20than the build host then you can add "-DBROKEN_GETADDRINFO" to CFLAGS 21to force the previous IPv4-only behaviour. 22 23IPv6 known to work: 5.1ML7 5.2ML2 5.2ML5 24IPv6 known broken: 4.3.3ML11 5.1ML4 25 26If you wish to use dynamic libraries that aren't in the normal system 27locations (eg IBM's OpenSSL and zlib packages) then you will need to 28define the environment variable blibpath before running configure, eg 29 30blibpath=/lib:/usr/lib:/opt/freeware/lib ./configure \ 31 --with-ssl-dir=/opt/freeware --with-zlib=/opt/freeware 32 33If sshd is built with the WITH_AIXAUTHENTICATE option (which is enabled 34by default) then sshd checks that users are permitted via the 35loginrestrictions() function, in particular that the user has the 36"rlogin" attribute set. This check is not done for the root account, 37instead the PermitRootLogin setting in sshd_config is used. 38 39 40Cygwin 41------ 42To build on Cygwin, OpenSSH requires the following packages: 43gcc, gcc-mingw-core, mingw-runtime, binutils, make, openssl, 44openssl-devel, zlib, minres, minires-devel. 45 46 47Darwin and MacOS X 48------------------ 49Darwin does not provide a tun(4) driver required for OpenSSH-based 50virtual private networks. The BSD manpage still exists, but the driver 51has been removed in recent releases of Darwin and MacOS X. 52 53Nevertheless, tunnel support is known to work with Darwin 8 and 54MacOS X 10.4 in Point-to-Point (Layer 3) and Ethernet (Layer 2) mode 55using a third party driver. More information is available at: 56 http://www-user.rhrk.uni-kl.de/~nissler/tuntap/ 57 58 59Linux 60----- 61 62Some Linux distributions (including Red Hat/Fedora/CentOS) include 63headers and library links in the -devel RPMs rather than the main 64binary RPMs. If you get an error about headers, or complaining about a 65missing prerequisite then you may need to install the equivalent 66development packages. On Redhat based distros these may be openssl-devel, 67zlib-devel and pam-devel, on Debian based distros these may be 68libssl-dev, libz-dev and libpam-dev. 69 70 71Solaris 72------- 73If you enable BSM auditing on Solaris, you need to update audit_event(4) 74for praudit(1m) to give sensible output. The following line needs to be 75added to /etc/security/audit_event: 76 77 32800:AUE_openssh:OpenSSH login:lo 78 79The BSM audit event range available for third party TCB applications is 8032768 - 65535. Event number 32800 has been choosen for AUE_openssh. 81There is no official registry of 3rd party event numbers, so if this 82number is already in use on your system, you may change it at build time 83by configure'ing --with-cflags=-DAUE_openssh=32801 then rebuilding. 84 85 86Platforms using PAM 87------------------- 88As of OpenSSH 4.3p1, sshd will no longer check /etc/nologin itself when 89PAM is enabled. To maintain existing behaviour, pam_nologin should be 90added to sshd's session stack which will prevent users from starting shell 91sessions. Alternatively, pam_nologin can be added to either the auth or 92account stacks which will prevent authentication entirely, but will still 93return the output from pam_nologin to the client. 94 95 96$Id: README.platform,v 1.10 2009/08/28 23:14:48 dtucker Exp $ 97