Portable OpenSSH
Go to file
Darren Tucker e0ba38861c Skip scp3 test on dragonfly 58 and 60.
The tests hang, so skip until we figure them out.
2021-08-13 13:00:14 +10:00
.github Skip scp3 test on dragonfly 58 and 60. 2021-08-13 13:00:14 +10:00
contrib crank version in README and RPM spec files 2021-04-16 13:53:02 +10:00
m4 Replace AC_TRY_COMPILE obsoleted in autoconf 2.70. 2020-11-06 13:56:41 +11:00
openbsd-compat Add includes.h to compat tests. 2021-08-11 09:21:09 +10:00
regress upstream: test -Oprint-pubkey 2021-08-11 18:56:35 +10:00
.depend upstream: on fatal errors, make scp wait for ssh connection before 2021-08-10 12:47:39 +10:00
.gitignore Add aclocal.m4 and config.h.in~ to .gitignore. 2020-09-11 13:18:42 +10:00
.skipped-commit-ids upstream: Import regenerated moduli file. 2021-03-13 13:09:28 +11:00
addr.c ifdef new instance of sin6_scope_id 2021-01-23 18:28:37 +11:00
addr.h upstream: Move address handling functions out into their own file 2021-01-11 15:04:12 +11:00
addrmatch.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
atomicio.c
atomicio.h
audit-bsm.c polish whitespace for portable files 2021-04-03 17:47:37 +11:00
audit-linux.c
audit.c
audit.h
auth2-chall.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
auth2-gss.c upstream: this needs kex.h now 2021-01-27 21:16:45 +11:00
auth2-hostbased.c upstream: Let allowed signers files used by ssh-keygen(1) 2021-07-23 14:07:19 +10:00
auth2-kbdint.c Sync remaining ChallengeResponse removal. 2021-07-03 19:23:28 +10:00
auth2-none.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
auth2-passwd.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
auth2-pubkey.c upstream: Let allowed signers files used by ssh-keygen(1) 2021-07-23 14:07:19 +10:00
auth2.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
auth-bsdauth.c
auth-krb5.c polish whitespace for portable files 2021-04-03 17:47:37 +11:00
auth-options.c upstream: don't leak environment= variable when it is not the first 2021-07-24 12:30:58 +10:00
auth-options.h upstream: make authorized_keys environment="..." directives 2021-07-23 14:07:19 +10:00
auth-pam.c Remove reference to ChallengeResponse. 2021-07-03 23:00:19 +10:00
auth-pam.h
auth-passwd.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
auth-rhosts.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
auth-shadow.c
auth-sia.c
auth-sia.h
auth.c upstream: Remove comment referencing now-removed 2021-07-08 14:50:59 +10:00
auth.h upstream: move subprocess() from auth.c to misc.c 2020-12-22 15:43:59 +11:00
authfd.c upstream: factor out common code in the agent client 2021-01-26 12:21:48 +11:00
authfd.h
authfile.c
authfile.h
bitmap.c
bitmap.h
buildpkg.sh.in whitespace at EOL 2020-12-22 19:43:55 +11:00
canohost.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
canohost.h
chacha.c
chacha.h upstream: whitespace (tab after space) 2021-04-03 17:20:00 +11:00
channels.c Remove duplicate error on error path. 2021-07-03 20:34:19 +10:00
channels.h upstream: restore blocking status on stdio fds before close 2021-05-19 11:52:14 +10:00
cipher-aes.c
cipher-aesctr.c
cipher-aesctr.h
cipher-chachapoly-libcrypto.c
cipher-chachapoly.c
cipher-chachapoly.h
cipher-ctr.c
cipher.c polish whitespace for portable files 2021-04-03 17:47:37 +11:00
cipher.h
cleanup.c
clientloop.c upstream: Add a ForkAfterAuthentication ssh_config(5) counterpart 2021-07-23 14:07:19 +10:00
clientloop.h
compat.c upstream: Client-side workaround for a bug in OpenSSH 7.4: this release 2021-06-06 13:41:36 +10:00
compat.h upstream: Client-side workaround for a bug in OpenSSH 7.4: this release 2021-06-06 13:41:36 +10:00
config.guess
config.sub
configure.ac Add configure-time detection for SSH_TIME_T_MAX. 2021-07-12 18:21:26 +10:00
CREDITS
crypto_api.h upstream: Update the sntrup761 creation script and generated code: 2021-01-08 13:49:49 +11:00
defines.h Add configure-time detection for SSH_TIME_T_MAX. 2021-07-12 18:21:26 +10:00
dh.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
dh.h upstream: Add ModuliFile keyword to sshd_config to specify the 2021-03-13 13:14:13 +11:00
digest-libc.c
digest-openssl.c upstream: whitespace; no code change 2020-10-29 13:54:13 +11:00
digest.h
dispatch.c
dispatch.h
dns.c upstream: Ensure that all returned SSHFP records for the specified host 2021-07-19 13:46:13 +10:00
dns.h upstream: Ensure that all returned SSHFP records for the specified host 2021-07-19 13:46:13 +10:00
ed25519.c
entropy.c Split EGD/PRNGD interface into its own file. 2021-06-18 18:32:51 +10:00
entropy.h
fatal.c upstream: fix SEGV on fatal() errors spotted by dtucker@ 2020-10-19 19:09:08 +11:00
fe25519.c
fe25519.h
fixalgorithms
fixpaths
ge25519_base.data
ge25519.c
ge25519.h
groupaccess.c
groupaccess.h
gss-genr.c upstream: make ssh->kex->session_id a sshbuf instead of u_char*/size_t 2021-01-27 21:10:57 +11:00
gss-serv-krb5.c
gss-serv.c
hash.c Remove old OpenBSD version marker. 2021-07-03 20:36:06 +10:00
hmac.c
hmac.h
hostfile.c upstream: Order includes as per style(9). Portable already has 2021-07-08 14:51:47 +10:00
hostfile.h upstream: make struct hostkeys public; I have no idea why I made it 2021-01-26 12:21:48 +11:00
includes.h
INSTALL Update comments about EGD to include prngd. 2021-07-09 14:34:06 +10:00
install-sh
int32_minmax.inc upstream: estructure sntrup761.sh to process all files in a single 2021-01-08 13:46:35 +11:00
kex.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
kex.h upstream: more strictly enforce KEX state-machine by banning packet 2021-02-01 09:57:28 +11:00
kexc25519.c
kexdh.c Move signal.h up include order to match upstream. 2021-07-03 20:38:09 +10:00
kexecdh.c
kexgen.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
kexgex.c
kexgexc.c upstream: more strictly enforce KEX state-machine by banning packet 2021-02-01 09:57:28 +11:00
kexgexs.c upstream: more strictly enforce KEX state-machine by banning packet 2021-02-01 09:57:28 +11:00
kexsntrup761x25519.c Disable sntrup761 if compiler doesn't support VLAs. 2021-01-26 14:48:07 +11:00
krl.c upstream: The RB_GENERATE_STATIC(3) macro expands to a series of 2021-06-04 16:20:28 +10:00
krl.h
LICENCE add some openbsd-compat licenses we missed 2020-10-03 13:39:17 +10:00
log.c upstream: include pid in LogVerbose spam 2021-05-10 10:58:11 +10:00
log.h upstream: do not pass file/func to monitor; noted by Ilja van Sprundel; 2021-04-16 13:24:33 +10:00
loginrec.c support NetBSD's utmpx.ut_ss address field 2020-08-05 08:58:57 +10:00
loginrec.h polish whitespace for portable files 2021-04-03 17:47:37 +11:00
logintest.c polish whitespace for portable files 2021-04-03 17:47:37 +11:00
mac.c
mac.h
Makefile.in upstream: support for using the SFTP protocol for file transfers in 2021-08-03 11:03:09 +10:00
match.c upstream: fold consecutive '*' wildcards to mitigate combinatorial 2020-11-04 10:09:25 +11:00
match.h
md5crypt.c
md5crypt.h
mdoc2man.awk
misc.c upstream: SFTP protocol extension to allow the server to expand 2021-08-10 12:47:46 +10:00
misc.h upstream: SFTP protocol extension to allow the server to expand 2021-08-10 12:47:46 +10:00
mkinstalldirs
moduli upstream: Regenerate moduli. 2021-05-17 19:25:00 +10:00
moduli.5
moduli.c
monitor_fdpass.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
monitor_fdpass.h
monitor_wrap.c upstream: do not pass file/func to monitor; noted by Ilja van Sprundel; 2021-04-16 13:24:33 +10:00
monitor_wrap.h upstream: do not pass file/func to monitor; noted by Ilja van Sprundel; 2021-04-16 13:24:33 +10:00
monitor.c upstream: remove a bunch of %p in format strings; leftovers of 2021-08-11 18:37:30 +10:00
monitor.h
msg.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
msg.h
mux.c upstream: Add a StdinNull directive to ssh_config(5) that allows 2021-07-23 14:07:19 +10:00
myproposal.h upstream: prefer ed25519 signature algorithm variants to ECDSA; ok 2020-10-03 14:34:06 +10:00
nchan2.ms
nchan.c upstream: restore blocking status on stdio fds before close 2021-05-19 11:52:14 +10:00
nchan.ms
openssh.xml.in
opensshd.init.in
OVERVIEW
packet.c upstream: Explicitly check for and start time-based rekeying in the 2021-07-16 19:21:04 +10:00
packet.h upstream: Explicitly check for and start time-based rekeying in the 2021-07-16 19:21:04 +10:00
pathnames.h
pkcs11.h
platform-misc.c
platform-pledge.c
platform-tracing.c
platform.c
platform.h
poly1305.c
poly1305.h
progressmeter.c
progressmeter.h
PROTOCOL upstream: SFTP protocol extension to allow the server to expand 2021-08-10 12:47:46 +10:00
PROTOCOL.agent upstream: Agent protocol draft is now at rev 4. ok djm@ 2020-10-07 13:34:11 +11:00
PROTOCOL.certkeys upstream: PROTOCOL.certkeys: update reference from IETF draft to 2021-06-06 13:24:37 +10:00
PROTOCOL.chacha20poly1305
PROTOCOL.key upstream: correct mistake in spec - the private key blobs are encoded 2021-05-07 12:36:18 +10:00
PROTOCOL.krl
PROTOCOL.mux
PROTOCOL.sshsig upstream: Add RCS IDs to the few files that are missing them; from 2020-08-31 14:34:41 +10:00
PROTOCOL.u2f upstream: when writing an attestation blob for a FIDO key, record all 2020-09-09 13:11:34 +10:00
readconf.c upstream: Add a ForkAfterAuthentication ssh_config(5) counterpart 2021-07-23 14:07:19 +10:00
readconf.h upstream: Add a ForkAfterAuthentication ssh_config(5) counterpart 2021-07-23 14:07:19 +10:00
README crank version in README and RPM spec files 2021-04-16 13:53:02 +10:00
README.dns
README.md Add status badges for Actions-based tests. 2021-04-29 10:59:54 +10:00
README.platform Improve AIX text. 2020-12-22 19:21:26 +11:00
README.privsep
README.tun
readpass.c upstream: mention in comment that read_passphrase(..., RP_ALLOW_STDIN) 2021-07-23 15:57:56 +10:00
rijndael.c
rijndael.h
sandbox-capsicum.c
sandbox-darwin.c
sandbox-null.c
sandbox-pledge.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
sandbox-rlimit.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
sandbox-seccomp-filter.c polish whitespace for portable files 2021-04-03 17:47:37 +11:00
sandbox-solaris.c
sandbox-systrace.c
sc25519.c
sc25519.h
scp.1 upstream: scp: tweak man page and error message for -3 by default 2021-08-12 23:03:13 +10:00
scp.c upstream: scp: tweak man page and error message for -3 by default 2021-08-12 23:03:13 +10:00
servconf.c Remove now-unused SSHv1 enums. 2021-07-02 15:43:28 +10:00
servconf.h Sync remaining ChallengeResponse removal. 2021-07-03 19:23:28 +10:00
serverloop.c upstream: Explicitly check for and start time-based rekeying in the 2021-07-16 19:21:04 +10:00
serverloop.h
session.c upstream: remove a bunch of %p in format strings; leftovers of 2021-08-11 18:37:30 +10:00
session.h
sftp-client.c upstream: SFTP protocol extension to allow the server to expand 2021-08-10 12:47:46 +10:00
sftp-client.h upstream: SFTP protocol extension to allow the server to expand 2021-08-10 12:47:46 +10:00
sftp-common.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
sftp-common.h
sftp-glob.c
sftp-realpath.c
sftp-server-main.c
sftp-server.8 upstream: standardise the grammar in the options list; issue 2021-08-03 09:39:57 +10:00
sftp-server.c upstream: SFTP protocol extension to allow the server to expand 2021-08-10 12:47:46 +10:00
sftp.1 Sync remaining ChallengeResponse removal. 2021-07-03 19:23:28 +10:00
sftp.c upstream: In the editline(3) branch of the sftp(1) event loop, 2021-08-12 23:05:33 +10:00
sftp.h
sk-api.h upstream: make names in function prototypes match those in 2021-02-18 13:17:43 +11:00
sk-usbhid.c upstream: Hash challenge supplied by client during FIDO key enrollment 2021-05-31 16:50:00 +10:00
smult_curve25519_ref.c
sntrup761.c Disable sntrup761 if compiler doesn't support VLAs. 2021-01-26 14:48:07 +11:00
sntrup761.sh upstream: Update the sntrup761 creation script and generated code: 2021-01-08 13:49:49 +11:00
srclimit.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
srclimit.h upstream: Add PerSourceMaxStartups and PerSourceNetBlockSize 2021-01-11 15:04:12 +11:00
ssh2.h upstream: draft-ietf-secsh-architecture is now RFC4251. 2020-11-20 13:34:46 +11:00
ssh_api.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
ssh_api.h
ssh_config upstream: Add a '%k' TOKEN that expands to the effective HostKey of 2020-07-17 13:52:46 +10:00
ssh_config.5 upstream: mention that CASignatureAlgorithms accepts +/- similarly to 2021-08-13 10:01:15 +10:00
ssh-add.1
ssh-add.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
ssh-agent.1 Avoid lines >80 chars. From jmc@ 2021-08-03 21:02:33 +10:00
ssh-agent.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
ssh-dss.c
ssh-ecdsa-sk.c
ssh-ecdsa.c
ssh-ed25519-sk.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
ssh-ed25519.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
ssh-gss.h upstream: make ssh->kex->session_id a sshbuf instead of u_char*/size_t 2021-01-27 21:10:57 +11:00
ssh-keygen.1 upstream: when verifying sshsig signatures, support an option 2021-08-11 18:56:29 +10:00
ssh-keygen.c upstream: when verifying sshsig signatures, support an option 2021-08-11 18:56:29 +10:00
ssh-keyscan.1
ssh-keyscan.c upstream: remove global variable used to stash compat flags and use the 2021-01-27 20:28:25 +11:00
ssh-keysign.8
ssh-keysign.c upstream: Order includes as per style(9). Portable already has 2021-07-08 14:51:47 +10:00
ssh-pkcs11-client.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
ssh-pkcs11-helper.8
ssh-pkcs11-helper.c upstream: remove a bunch of %p in format strings; leftovers of 2021-08-11 18:37:30 +10:00
ssh-pkcs11.c upstream: remove a bunch of %p in format strings; leftovers of 2021-08-11 18:37:30 +10:00
ssh-pkcs11.h
ssh-rsa.c
ssh-sandbox.h
ssh-sk-client.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
ssh-sk-helper.8
ssh-sk-helper.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
ssh-sk.c upstream: a bit more debugging behind #ifdef DEBUG_SK 2021-02-26 11:18:26 +11:00
ssh-sk.h
ssh-xmss.c upstream: Adapt XMSS to new logging infrastructure. With markus@, ok 2020-10-20 10:15:02 +11:00
ssh.1 upstream: no need to talk about version 2 with the -Q option, so 2021-08-03 09:39:57 +10:00
ssh.c upstream: xstrdup environment variable used by ForwardAgent. bz#3328 2021-08-08 19:14:51 +10:00
ssh.h
sshbuf-getput-basic.c
sshbuf-getput-crypto.c
sshbuf-io.c
sshbuf-misc.c upstream: oops, missed one more %p 2021-08-11 18:37:30 +10:00
sshbuf.c
sshbuf.h
sshconnect2.c upstream: note successful authentication method in final "Authenticated 2021-07-23 15:25:19 +10:00
sshconnect.c Sync remaining ChallengeResponse removal. 2021-07-03 19:23:28 +10:00
sshconnect.h upstream: add a ssh_config KnownHostsCommand that allows the client 2020-12-22 15:43:59 +11:00
sshd_config Replace remaining references to ChallengeResponse. 2021-07-03 19:27:43 +10:00
sshd_config.5 upstream: mention that CASignatureAlgorithms accepts +/- similarly to 2021-08-13 10:01:15 +10:00
sshd.8 upstream: fix a formatting error and add some Xr; from debian at 2021-08-03 09:39:58 +10:00
sshd.c upstream: Id sync only, -portable already has this. 2021-07-19 13:04:52 +10:00
ssherr.c
ssherr.h
sshkey-xmss.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
sshkey-xmss.h upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
sshkey.c upstream: Let allowed signers files used by ssh-keygen(1) 2021-07-23 14:07:19 +10:00
sshkey.h upstream: Let allowed signers files used by ssh-keygen(1) 2021-07-23 14:07:19 +10:00
sshlogin.c upstream: use the new variant log macros instead of prepending 2020-10-18 23:46:29 +11:00
sshlogin.h
sshpty.c Include stdio.h for FILE in misc.h. 2020-12-22 18:56:54 +11:00
sshpty.h
sshsig.c upstream: Add a StdinNull directive to ssh_config(5) that allows 2021-07-23 14:07:19 +10:00
sshsig.h upstream: Let allowed signers files used by ssh-keygen(1) 2021-07-23 14:07:19 +10:00
sshtty.c
survey.sh.in
TODO
ttymodes.c upstream: remove global variable used to stash compat flags and use the 2021-01-27 20:28:25 +11:00
ttymodes.h
uidswap.c polish whitespace for portable files 2021-04-03 17:47:37 +11:00
uidswap.h
umac128.c
umac.c upstream: typos in comments; GHPR#180 from Vill 2021-04-03 17:59:32 +11:00
umac.h
utf8.c
utf8.h upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
verify.c
version.h upstream: openssh-8.6 2021-04-16 13:43:30 +10:00
xmalloc.c
xmalloc.h upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
xmss_commons.c
xmss_commons.h
xmss_fast.c
xmss_fast.h
xmss_hash_address.c
xmss_hash_address.h
xmss_hash.c
xmss_hash.h
xmss_wots.c
xmss_wots.h

Portable OpenSSH

C/C++ CI Fuzzing Status

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).

Documentation

The official documentation for OpenSSH are the man pages for each tool:

Stable Releases

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.

Building Portable OpenSSH

Dependencies

Portable OpenSSH is built using autoconf and make. It requires a working C compiler, standard library and headers.

libcrypto from either LibreSSL or OpenSSL may also be used, but OpenSSH may be built without it supporting a subset of crypto algorithms.

zlib is optional; without it transport compression is not supported.

FIDO security token support needs libfido2 and its dependencies. Also, certain platforms and build-time options may require additional dependencies; see README.platform for details.

Building a release

Releases include a pre-built copy of the configure script and may be built using:

tar zxvf openssh-X.YpZ.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.

Building from git

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

Build-time Customisation

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.

Development

Portable OpenSSH development is discussed on the openssh-unix-dev mailing list (archive mirror). Bugs and feature requests are tracked on our Bugzilla.

Reporting bugs

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.