1
0
mirror of git://anongit.mindrot.org/openssh.git synced 2024-12-25 03:12:10 +00:00
Portable OpenSSH
Go to file
Darren Tucker df93529dd7 Test if sshd accidentally acquires controlling tty
When SSHD_ACQUIRES_CTTY is defined, test for the problematic behaviour
in the STREAMS code before activating the workaround.  ok djm@
2022-02-14 14:19:40 +11:00
.github Add cygwin-release test config. 2022-02-12 10:24:56 +11:00
contrib remove built-in support for md5crypt() 2021-10-28 16:16:13 +11:00
m4
openbsd-compat Test if sshd accidentally acquires controlling tty 2022-02-14 14:19:40 +11:00
regress Fix helper include path and remove excess code. 2022-02-11 10:05:31 +11:00
.depend depend 2022-01-25 11:52:34 +11:00
.gitignore
.skipped-commit-ids upstream: ssh-add side of destination constraints 2021-12-20 09:27:06 +11:00
addr.c upstream: Plug mem addrinfo mem leaks. 2021-10-22 22:03:05 +11:00
addr.h
addrmatch.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
atomicio.c remove sys/param.h in -portable, after upstream 2021-12-22 09:02:50 +11:00
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
auth2-gss.c upstream: prepare for multiple names for authmethods 2021-12-20 09:28:07 +11:00
auth2-hostbased.c upstream: include rejected signature algorithm in error message 2022-01-07 09:21:38 +11:00
auth2-kbdint.c upstream: prepare for multiple names for authmethods 2021-12-20 09:28:07 +11:00
auth2-none.c upstream: prepare for multiple names for authmethods 2021-12-20 09:28:07 +11:00
auth2-passwd.c upstream: prepare for multiple names for authmethods 2021-12-20 09:28:07 +11:00
auth2-pubkey.c upstream: sshd side of hostbound public key auth 2021-12-20 09:28:07 +11:00
auth2.c upstream: split method list search functionality from 2021-12-27 10:40:22 +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: Switch hpdelim interface to accept only ":" as delimiter. 2022-02-10 15:14:17 +11:00
auth-options.h upstream: make authorized_keys environment="..." directives 2021-07-23 14:07:19 +10:00
auth-pam.c Fix memory leak in error path. 2021-09-03 13:42:08 +10:00
auth-pam.h
auth-passwd.c
auth-rhosts.c upstream: mark const string array contents const too, i.e. static 2022-02-02 10:38:59 +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: prepare for multiple names for authmethods 2021-12-20 09:28:07 +11:00
authfd.c upstream: ssh-add side of destination constraints 2021-12-20 09:25:17 +11:00
authfd.h upstream: ssh-add side of destination constraints 2021-12-20 09:25:17 +11:00
authfile.c upstream: spelling ok dtucker@ 2022-01-01 15:19:48 +11:00
authfile.h
bitmap.c
bitmap.h
buildpkg.sh.in
canohost.c
canohost.h
chacha.c
chacha.h upstream: whitespace (tab after space) 2021-04-03 17:20:00 +11:00
channels.c Put poll.h inside ifdef. 2022-02-10 23:51:02 +11:00
channels.h upstream: add a ssh_packet_process_read() function that reads from 2022-01-25 12:18:35 +11: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 Put poll.h inside ifdef. 2022-02-10 23:51:02 +11:00
clientloop.h
compat.c upstream: openssh-7.4 was incorrectly listed twice; spotted by 2021-09-10 20:34:09 +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 Simplify handling of --with-ssl-dir. 2022-02-11 20:09:32 +11:00
CREDITS
crypto_api.h
defines.h Correct value for IPTOS_DSCP_LE. 2021-12-15 10:50:33 +11: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 Use SHA.*_HMAC_BLOCK_SIZE if needed. 2021-12-23 11:36:08 +11:00
digest-openssl.c
digest.h
dispatch.c
dispatch.h
dns.c upstream: mark const string array contents const too, i.e. static 2022-02-02 10:38:59 +11: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
fe25519.c
fe25519.h
fixalgorithms
fixpaths
ge25519_base.data
ge25519.c
ge25519.h
groupaccess.c
groupaccess.h
gss-genr.c need stdlib.h for free(3) 2021-10-01 16:36:24 +10: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: piece of UpdateHostkeys client strictification: when 2022-01-07 09:21:38 +11: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 remove sys/param.h in -portable, after upstream 2021-12-22 09:02:50 +11:00
INSTALL remove built-in support for md5crypt() 2021-10-28 16:16:13 +11:00
install-sh
int32_minmax.inc
kex.c upstream: mark const string array contents const too, i.e. static 2022-02-02 10:38:59 +11:00
kex.h upstream: Fix signature algorithm selection logic for 2022-01-07 09:21:38 +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: Record session ID, host key and sig at intital KEX 2021-12-20 09:24:42 +11:00
kexgex.c
kexgexc.c upstream: Record session ID, host key and sig at intital KEX 2021-12-20 09:24:42 +11:00
kexgexs.c upstream: Record session ID, host key and sig at intital KEX 2021-12-20 09:24:42 +11:00
kexsntrup761x25519.c upstream: fix unintended sizeof pointer in debug path ok markus@ 2021-12-07 12:30:50 +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 Fix typo in Neils' name. 2021-11-29 14:03:19 +11:00
log.c upstream: allow log_stderr==2 to prefix log messages with argv[0] 2021-09-19 17:21:59 +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 remove sys/param.h in -portable, after upstream 2021-12-22 09:02:50 +11: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: Add unit tests for hpdelim. 2022-02-10 15:17:28 +11:00
match.c
match.h
mdoc2man.awk
misc.c upstream: Always initialize delim before passing to hpdelim2 which 2022-02-11 12:17:07 +11:00
misc.h upstream: replace select() with ppoll(), including converting 2021-11-18 09:09:59 +11:00
mkinstalldirs
moduli upstream: Import regenerated moduli. 2021-09-29 11:00:50 +10:00
moduli.5
moduli.c
monitor_fdpass.c
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: When it's the possessive of 'it', it's spelled "its", 2022-02-01 19:20:30 +11:00
monitor.h
msg.c
msg.h
mux.c upstream: suppress "Connection to xxx closed" messages at LogLevel >= 2022-01-12 09:33:35 +11:00
myproposal.h upstream: add the sntrup761x25519-sha512@openssh.com hybrid 2021-11-10 17:32:18 +11:00
nchan2.ms
nchan.c upstream: mark const string array contents const too, i.e. static 2022-02-02 10:38:59 +11:00
nchan.ms
openssh.xml.in
opensshd.init.in Replace shell function with ssh-keygen -A. 2021-08-20 18:14:13 +10:00
OVERVIEW
packet.c upstream: add a ssh_packet_process_read() function that reads from 2022-01-25 12:18:35 +11:00
packet.h upstream: add a ssh_packet_process_read() function that reads from 2022-01-25 12:18:35 +11:00
pathnames.h
pkcs11.h
platform-misc.c
platform-pledge.c
platform-tracing.c Include string.h and stdio.h for strerror. 2021-10-15 12:59:06 +11:00
platform.c
platform.h
poly1305.c
poly1305.h
progressmeter.c
progressmeter.h
PROTOCOL upstream: document host-bound publickey authentication 2021-12-20 09:28:08 +11:00
PROTOCOL.agent upstream: spelling ok dtucker@ 2022-01-01 15:19:48 +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 upstream: spelling ok dtucker@ 2022-01-01 15:19:48 +11:00
PROTOCOL.sshsig
PROTOCOL.u2f
readconf.c upstream: Switch hpdelim interface to accept only ":" as delimiter. 2022-02-10 15:14:17 +11:00
readconf.h upstream: PubkeyAuthentication=yes|no|unbound|host-bound 2021-12-20 09:28:08 +11:00
README update version numbers for release 2021-09-26 22:16:36 +10:00
README.dns
README.md Add status badges for Actions-based tests. 2021-04-29 10:59:54 +10:00
README.platform
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 upstream: Make prototype for rijndaelEncrypt match function 2021-09-29 11:09:27 +10:00
sandbox-capsicum.c remove sys/param.h in -portable, after upstream 2021-12-22 09:02:50 +11:00
sandbox-darwin.c
sandbox-null.c
sandbox-pledge.c
sandbox-rlimit.c
sandbox-seccomp-filter.c sandbox-seccomp-filter: allow gettid 2022-01-31 16:45:10 +11:00
sandbox-solaris.c
sandbox-systrace.c
sc25519.c
sc25519.h
scp.1 upstream: revert for imminent OpenSSH release, which wil ship with 2022-02-10 15:14:24 +11:00
scp.c upstream: revert for imminent OpenSSH release, which wil ship with 2022-02-10 15:14:24 +11:00
SECURITY.md basic SECURITY.md (refers people to the website) 2021-11-03 12:08:21 +11:00
servconf.c upstream: Switch hpdelim interface to accept only ":" as delimiter. 2022-02-10 15:14:17 +11:00
servconf.h Sync remaining ChallengeResponse removal. 2021-07-03 19:23:28 +10:00
serverloop.c Put poll.h inside ifdef. 2022-02-10 23:51:02 +11:00
serverloop.h
session.c upstream: Switch hpdelim interface to accept only ":" as delimiter. 2022-02-10 15:14:17 +11:00
session.h
sftp-client.c Remove line leftover from upstream sync. 2022-01-18 12:55:21 +11:00
sftp-client.h upstream: spelling ok dtucker@ 2022-01-01 15:19:48 +11:00
sftp-common.c
sftp-common.h
sftp-glob.c
sftp-realpath.c upstream: sys/param.h is not needed for any visible reason 2021-09-03 14:20:22 +10:00
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: mark const string array contents const too, i.e. static 2022-02-02 10:38:59 +11:00
sftp.1 Sync remaining ChallengeResponse removal. 2021-07-03 19:23:28 +10:00
sftp.c remove sys/param.h in -portable, after upstream 2021-12-22 09:02:50 +11:00
sftp.h
sk-api.h upstream: Better handle FIDO keys on tokens that provide user 2021-11-03 10:07:23 +11:00
sk-usbhid.c fix typos in previous 2022-02-07 21:26:14 +11: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
srclimit.c upstream: highly polished whitespace, mostly fixing spaces-for-tab 2021-04-03 17:23:02 +11:00
srclimit.h
ssh2.h
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
ssh_config.5 upstream: Since they are deprecated, move DSA to the end of the 2022-02-07 12:27:48 +11:00
ssh-add.1 upstream: Since they are deprecated, move DSA to the end of the 2022-02-07 12:27:48 +11:00
ssh-add.c upstream: Since they are deprecated, move DSA to the end of the 2022-02-07 12:27:48 +11:00
ssh-agent.1 Avoid lines >80 chars. From jmc@ 2021-08-03 21:02:33 +10:00
ssh-agent.c upstream: allow pin-required FIDO keys to be added to ssh-agent(1). 2022-01-18 10:00:35 +11:00
ssh-dss.c
ssh-ecdsa-sk.c
ssh-ecdsa.c
ssh-ed25519-sk.c
ssh-ed25519.c
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: remove please from manual pages ok jmc@ sthen@ millert@ 2022-02-07 12:27:48 +11:00
ssh-keygen.c upstream: mark const string array contents const too, i.e. static 2022-02-02 10:38:59 +11:00
ssh-keyscan.1
ssh-keyscan.c upstream: When poll(2) returns -1, for some error conditions 2022-01-25 10:33:03 +11:00
ssh-keysign.8
ssh-keysign.c upstream: make ssh-keysign use the requested signature algorithm 2022-01-07 09:21:38 +11:00
ssh-pkcs11-client.c make OPENSSL_HAS_ECC checks more thorough 2021-10-01 16:36:24 +10:00
ssh-pkcs11-helper.8
ssh-pkcs11-helper.c upstream: check for POLLHUP wherever we check for POLLIN 2021-11-18 14:32:54 +11:00
ssh-pkcs11.c upstream: avoid xmalloc(0) for PKCS#11 keyid for ECDSA keys (we 2021-11-19 08:12:57 +11:00
ssh-pkcs11.h
ssh-rsa.c
ssh-sandbox.h
ssh-sk-client.c upstream: sshsk_load_resident: don't preallocate resp 2022-01-14 14:40:40 +11:00
ssh-sk-helper.8
ssh-sk-helper.c upstream: When downloading resident keys from a FIDO token, pass 2021-10-28 13:56:59 +11:00
ssh-sk.c upstream: ssh-sk: free a resident key's user id 2022-01-14 14:40:40 +11:00
ssh-sk.h upstream: When downloading resident keys from a FIDO token, pass 2021-10-28 13:56:59 +11:00
ssh-xmss.c
ssh.1 upstream: remove please from manual pages ok jmc@ sthen@ millert@ 2022-02-07 12:27:48 +11:00
ssh.c upstream: Switch hpdelim interface to accept only ":" as delimiter. 2022-02-10 15:14:17 +11:00
ssh.h
sshbuf-getput-basic.c
sshbuf-getput-crypto.c
sshbuf-io.c
sshbuf-misc.c upstream: Add a sshbuf_read() that attempts to read(2) directly in 2022-01-25 10:45:47 +11:00
sshbuf.c
sshbuf.h upstream: Add a sshbuf_read() that attempts to read(2) directly in 2022-01-25 10:45:47 +11:00
sshconnect2.c upstream: mark const string array contents const too, i.e. static 2022-02-02 10:38:59 +11:00
sshconnect.c upstream: ssh-add side of destination constraints 2021-12-20 09:25:17 +11:00
sshconnect.h
sshd_config Replace remaining references to ChallengeResponse. 2021-07-03 19:27:43 +10:00
sshd_config.5 upstream: RSA/SHA-1 is not used by default anymore on the server 2021-12-07 12:30:50 +11:00
sshd.8 upstream: Document that non-interactive commands are run via the user's 2021-09-10 22:05:35 +10:00
sshd.c Move SSHD_ACQUIRES_CTTY workaround into compat. 2022-02-11 21:00:35 +11: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: add a helper function to match a key type to a list of 2022-01-07 09:21:38 +11:00
sshkey.h upstream: add a helper function to match a key type to a list of 2022-01-07 09:21:38 +11:00
sshlogin.c
sshlogin.h
sshpty.c
sshpty.h
sshsig.c upstream: allow 'ssh-keygen -Y find-principals' to match wildcard 2022-02-02 10:38:59 +11:00
sshsig.h upstream: Add ssh-keygen -Y match-principals operation to perform 2021-11-27 18:22:41 +11: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: spelling 2022-01-04 18:22:46 +11:00
umac.h upstream: spelling ok dtucker@ 2022-01-01 15:19:48 +11:00
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.8 2021-09-27 00:03:12 +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.