commit | 6cf1c40096a79e5eedcf897c7cdb46bb32d4a3ee | [log] [tgz] |
---|---|---|
author | Darren Tucker <dtucker@dtucker.net> | Mon Nov 18 14:14:18 2019 +1100 |
committer | Darren Tucker <dtucker@dtucker.net> | Mon Nov 18 14:14:18 2019 +1100 |
tree | 25ea7b4b68c8c53944b1c3105aabf064e300f5d4 | |
parent | 103c51fd5f5ddc01cd6b5c1132e711765b921bf5 [diff] |
Enable -Wimplicit-fallthrough if supported Suggested by djm.
OpenSSH is a complete implementation of the SSH protocol (version 2) for secure remote login, command execution and file transfer. It includes a client ssh
and server sshd
, file transfer utilities scp
and sftp
as well as tools for key generation (ssh-keygen
), run-time key storage (ssh-agent
) and a number of supporting programs.
This is a port of OpenBSD's OpenSSH to most Unix-like operating systems, including Linux, OS X and Cygwin. Portable OpenSSH polyfills OpenBSD APIs that are not available elsewhere, adds sshd sandboxing for more operating systems and includes support for OS-native authentication and auditing (e.g. using PAM).
The official documentation for OpenSSH are the man pages for each tool:
Stable release tarballs are available from a number of download mirrors. We recommend the use of a stable release for most users. Please read the release notes for details of recent changes and potential incompatibilities.
Portable OpenSSH is built using autoconf and make. It requires a working C compiler, standard library and headers, as well as zlib and libcrypto
from either LibreSSL or OpenSSL to build. Certain platforms and build-time options may require additional dependencies.
Releases include a pre-built copy of the configure
script and may be built using:
tar zxvf openssh-X.Y.tar.gz cd openssh ./configure # [options] make && make tests
See the Build-time Customisation section below for configure options. If you plan on installing OpenSSH to your system, then you will usually want to specify destination paths.
If building from git, you'll need autoconf installed to build the configure
script. The following commands will check out and build portable OpenSSH from git:
git clone https://github.com/openssh/openssh-portable # or https://anongit.mindrot.org/openssh.git cd openssh-portable autoreconf ./configure make && make tests
There are many build-time customisation options available. All Autoconf destination path flags (e.g. --prefix
) are supported (and are usually required if you want to install OpenSSH).
For a full list of available flags, run configure --help
but a few of the more frequently-used ones are described below. Some of these flags will require additional libraries and/or headers be installed.
Flag | Meaning |
---|---|
--with-pam | Enable PAM support. OpenPAM, Linux PAM and Solaris PAM are supported. |
--with-libedit | Enable libedit support for sftp. |
--with-kerberos5 | Enable Kerberos/GSSAPI support. Both Heimdal and MIT Kerberos implementations are supported. |
--with-selinux | Enable SELinux support. |
--with-security-key-builtin | Include built-in support for U2F/FIDO2 security keys. This requires libfido2 be installed. |
Portable OpenSSH development is discussed on the openssh-unix-dev mailing list (archive mirror). Bugs and feature requests are tracked on our Bugzilla.
Non-security bugs may be reported to the developers via Bugzilla or via the mailing list above. Security bugs should be reported to openssh@openssh.com.