1
0
mirror of git://anongit.mindrot.org/openssh.git synced 2024-12-21 01:20:00 +00:00
Portable OpenSSH
Go to file
Darren Tucker 639c440f6c Define OPENSSL_NO_SHA including OpenSSL from test.
We don't use SHA256 from OpenSSL in the sk-dummy module and the
definitions can conflict with system sha2.h (eg on NetBSD) so define
OPENSSL_NO_SHA so we don't attempt to redefine them.
2021-10-06 17:09:31 +11:00
.github Disable security key on NetBSD4 test. 2021-10-06 15:40:58 +11:00
contrib update version numbers for release 2021-09-26 22:16:36 +10:00
m4
openbsd-compat Include stdlib.h for arc4random_uniform prototype. 2021-09-29 20:03:58 +10:00
regress Define OPENSSL_NO_SHA including OpenSSL from test. 2021-10-06 17:09:31 +11:00
.depend depend 2021-08-20 14:03:49 +10:00
.gitignore
.skipped-commit-ids
addr.c
addr.h
addrmatch.c
atomicio.c
atomicio.h
audit-bsm.c
audit-linux.c
audit.c
audit.h
auth2-chall.c
auth2-gss.c
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
auth2-passwd.c
auth2-pubkey.c upstream: add some debug output showing how many key file/command lines 2021-09-29 11:35:11 +10:00
auth2.c
auth-bsdauth.c
auth-krb5.c
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 Fix memory leak in error path. 2021-09-03 13:42:08 +10:00
auth-pam.h
auth-passwd.c
auth-rhosts.c
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
authfd.c
authfd.h
authfile.c
authfile.h
bitmap.c
bitmap.h
buildpkg.sh.in
canohost.c
canohost.h
chacha.c
chacha.h
channels.c upstream: put back the mux_ctx memleak fix for SSH_CHANNEL_MUX_CLIENT 2021-09-15 15:58:18 +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
cipher.h
cleanup.c
clientloop.c upstream: wrap at 80 columns 2021-08-30 09:58:15 +10: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 enable security key support for --without-openssl 2021-10-01 16:36:24 +10:00
CREDITS
crypto_api.h
defines.h Check compiler for c99 declarations after code. 2021-08-18 12:51:30 +10:00
dh.c
dh.h
digest-libc.c
digest-openssl.c
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
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: Dynamically allocate encoded HashKnownHosts and free as 2021-10-06 14:40:32 +11:00
hostfile.h
includes.h
INSTALL Update comments about EGD to include prngd. 2021-07-09 14:34:06 +10:00
install-sh
int32_minmax.inc
kex.c
kex.h
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
kexgex.c
kexgexc.c
kexgexs.c
kexsntrup761x25519.c
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
log.c upstream: allow log_stderr==2 to prefix log messages with argv[0] 2021-09-19 17:21:59 +10:00
log.h
loginrec.c
loginrec.h
logintest.c
mac.c
mac.h
Makefile.in clean regress/misc/sk-dummy in cleandir target 2021-10-06 15:07:01 +11:00
match.c
match.h
md5crypt.c
md5crypt.h
mdoc2man.awk
misc.c initgroups needs grp.h 2021-09-27 00:03:19 +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: Import regenerated moduli. 2021-09-29 11:00:50 +10:00
moduli.5
moduli.c
monitor_fdpass.c
monitor_fdpass.h
monitor_wrap.c
monitor_wrap.h
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
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: After years of forewarning, disable the RSA/SHA-1 2021-08-30 09:58:15 +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 Replace shell function with ssh-keygen -A. 2021-08-20 18:14:13 +10:00
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 Disable tracing on FreeBSD using procctl. 2021-09-09 18:13:27 +10:00
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
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
PROTOCOL.u2f
readconf.c upstream: missing space character in ssh -G output broke the 2021-09-16 15:38:16 +10:00
readconf.h upstream: allow CanonicalizePermittedCNAMEs=none in ssh_config; ok 2021-09-16 15:38:16 +10: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
sandbox-darwin.c
sandbox-null.c
sandbox-pledge.c
sandbox-rlimit.c
sandbox-seccomp-filter.c
sandbox-solaris.c
sandbox-systrace.c
sc25519.c
sc25519.h
scp.1 upstream: fix missing -s in SYNOPSYS and usage() as well as a 2021-09-21 08:06:09 +10:00
scp.c upstream: fix missing -s in SYNOPSYS and usage() as well as a 2021-09-21 08:06:09 +10:00
servconf.c upstream: revision 1.381 neglected to remove 2021-09-07 16:05:36 +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: Remove redundant attrib_clear in upload_dir_internal. 2021-09-03 17:32:31 +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
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: 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: Do not ignore SIGINT while waiting for input if editline(3) 2021-09-11 20:26:51 +10:00
sftp.h
sk-api.h
sk-usbhid.c fix FIDO key support for !OPENSSL_HAS_ECC case 2021-10-01 16:36:24 +10:00
smult_curve25519_ref.c
sntrup761.c
sntrup761.sh
srclimit.c
srclimit.h
ssh2.h
ssh_api.c
ssh_api.h
ssh_config
ssh_config.5 upstream: RSA/SHA-1 is not used by default anymore 2021-09-26 21:13:28 +10:00
ssh-add.1
ssh-add.c
ssh-agent.1 Avoid lines >80 chars. From jmc@ 2021-08-03 21:02:33 +10:00
ssh-agent.c
ssh-dss.c
ssh-ecdsa-sk.c
ssh-ecdsa.c
ssh-ed25519-sk.c
ssh-ed25519.c
ssh-gss.h
ssh-keygen.1 upstream: when verifying sshsig signatures, support an option 2021-08-11 18:56:29 +10:00
ssh-keygen.c upstream: Dynamically allocate encoded HashKnownHosts and free as 2021-10-06 14:40:32 +11:00
ssh-keyscan.1
ssh-keyscan.c upstream: Dynamically allocate encoded HashKnownHosts and free as 2021-10-06 14:40:32 +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 make OPENSSL_HAS_ECC checks more thorough 2021-10-01 16:36:24 +10: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 make OPENSSL_HAS_ECC checks more thorough 2021-10-01 16:36:24 +10:00
ssh-pkcs11.h
ssh-rsa.c
ssh-sandbox.h
ssh-sk-client.c
ssh-sk-helper.8
ssh-sk-helper.c
ssh-sk.c fix FIDO key support for !OPENSSL_HAS_ECC case 2021-10-01 16:36:24 +10:00
ssh-sk.h
ssh-xmss.c
ssh.1 upstream: Document behaviour of arguments following non-interactive 2021-09-10 20:34:09 +10:00
ssh.c upstream: Fix "Allocated port" debug message 2021-09-20 14:31:57 +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
sshd_config Replace remaining references to ChallengeResponse. 2021-07-03 19:27:43 +10:00
sshd_config.5 upstream: Refer to KEX "algorithms" instead of "methods" to match 2021-09-03 17:33:08 +10: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 upstream: Id sync only, -portable already has this. 2021-07-19 13:04:52 +10:00
ssherr.c
ssherr.h
sshkey-xmss.c
sshkey-xmss.h
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
sshlogin.h
sshpty.c
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
ttymodes.h
uidswap.c
uidswap.h
umac128.c
umac.c
umac.h
utf8.c
utf8.h
verify.c
version.h upstream: openssh-8.8 2021-09-27 00:03:12 +10:00
xmalloc.c
xmalloc.h
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.