Android S v2 Preview 2 (S2B2.211203.006)
Merge "_PATH_SSH_PROGRAM should point to ssh not sftp" am: 68ca7e1315 am: 1eafa1de31 am: 4c22b0272b

Original change: https://android-review.googlesource.com/c/platform/external/openssh/+/213336

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: Id6f592a0b4d99010c4bbfa4b13bde99a772aa5c0
tree: 510211ad5600141a8274e8b6d9af61b48a0c4296
  1. contrib/
  2. openbsd-compat/
  3. prebuilt-intermediates/
  4. regress/
  5. .depend
  6. .gitignore
  7. .skipped-commit-ids
  8. aclocal.m4
  9. addrmatch.c
  10. Android.bp
  11. atomicio.c
  12. atomicio.h
  13. audit-bsm.c
  14. audit-linux.c
  15. audit.c
  16. audit.h
  17. auth-bsdauth.c
  18. auth-krb5.c
  19. auth-options.c
  20. auth-options.h
  21. auth-pam.c
  22. auth-pam.h
  23. auth-passwd.c
  24. auth-rhosts.c
  25. auth-shadow.c
  26. auth-sia.c
  27. auth-sia.h
  28. auth.c
  29. auth.h
  30. auth2-chall.c
  31. auth2-gss.c
  32. auth2-hostbased.c
  33. auth2-kbdint.c
  34. auth2-none.c
  35. auth2-passwd.c
  36. auth2-pubkey.c
  37. auth2.c
  38. authfd.c
  39. authfd.h
  40. authfile.c
  41. authfile.h
  42. bitmap.c
  43. bitmap.h
  44. buildpkg.sh.in
  45. canohost.c
  46. canohost.h
  47. chacha.c
  48. chacha.h
  49. channels.c
  50. channels.h
  51. cipher-aes.c
  52. cipher-aesctr.c
  53. cipher-aesctr.h
  54. cipher-chachapoly-libcrypto.c
  55. cipher-chachapoly.c
  56. cipher-chachapoly.h
  57. cipher-ctr.c
  58. cipher.c
  59. cipher.h
  60. cleanup.c
  61. clientloop.c
  62. clientloop.h
  63. compat.c
  64. compat.h
  65. config.guess
  66. config.sub
  67. configure.ac
  68. CREDITS
  69. crypto_api.h
  70. defines.h
  71. dh.c
  72. dh.h
  73. digest-libc.c
  74. digest-openssl.c
  75. digest.h
  76. dispatch.c
  77. dispatch.h
  78. dns.c
  79. dns.h
  80. ed25519.c
  81. entropy.c
  82. entropy.h
  83. fatal.c
  84. fe25519.c
  85. fe25519.h
  86. fixalgorithms
  87. fixpaths
  88. ge25519.c
  89. ge25519.h
  90. ge25519_base.data
  91. groupaccess.c
  92. groupaccess.h
  93. gss-genr.c
  94. gss-serv-krb5.c
  95. gss-serv.c
  96. hash.c
  97. hmac.c
  98. hmac.h
  99. hostfile.c
  100. hostfile.h
  101. includes.h
  102. INSTALL
  103. install-sh
  104. kex.c
  105. kex.h
  106. kexc25519.c
  107. kexdh.c
  108. kexecdh.c
  109. kexgen.c
  110. kexgex.c
  111. kexgexc.c
  112. kexgexs.c
  113. kexsntrup4591761x25519.c
  114. krl.c
  115. krl.h
  116. LICENCE
  117. log.c
  118. log.h
  119. loginrec.c
  120. loginrec.h
  121. logintest.c
  122. mac.c
  123. mac.h
  124. Makefile.in
  125. match.c
  126. match.h
  127. md5crypt.c
  128. md5crypt.h
  129. mdoc2man.awk
  130. METADATA
  131. misc.c
  132. misc.h
  133. mkinstalldirs
  134. moduli
  135. moduli.5
  136. moduli.c
  137. monitor.c
  138. monitor.h
  139. monitor_fdpass.c
  140. monitor_fdpass.h
  141. monitor_wrap.c
  142. monitor_wrap.h
  143. msg.c
  144. msg.h
  145. mux.c
  146. myproposal.h
  147. nchan.c
  148. nchan.ms
  149. nchan2.ms
  150. openssh.xml.in
  151. opensshd.init.in
  152. OVERVIEW
  153. OWNERS
  154. packet.c
  155. packet.h
  156. pathnames.h
  157. pkcs11.h
  158. platform-misc.c
  159. platform-pledge.c
  160. platform-tracing.c
  161. platform.c
  162. platform.h
  163. poly1305.c
  164. poly1305.h
  165. progressmeter.c
  166. progressmeter.h
  167. PROTOCOL
  168. PROTOCOL.agent
  169. PROTOCOL.certkeys
  170. PROTOCOL.chacha20poly1305
  171. PROTOCOL.key
  172. PROTOCOL.krl
  173. PROTOCOL.mux
  174. PROTOCOL.sshsig
  175. PROTOCOL.u2f
  176. readconf.c
  177. readconf.h
  178. README
  179. README.dns
  180. README.md
  181. README.platform
  182. README.privsep
  183. README.tun
  184. README.version
  185. readpass.c
  186. rijndael.c
  187. rijndael.h
  188. sandbox-capsicum.c
  189. sandbox-darwin.c
  190. sandbox-null.c
  191. sandbox-pledge.c
  192. sandbox-rlimit.c
  193. sandbox-seccomp-filter.c
  194. sandbox-solaris.c
  195. sandbox-systrace.c
  196. sc25519.c
  197. sc25519.h
  198. scp.1
  199. scp.c
  200. servconf.c
  201. servconf.h
  202. serverloop.c
  203. serverloop.h
  204. session.c
  205. session.h
  206. sftp-client.c
  207. sftp-client.h
  208. sftp-common.c
  209. sftp-common.h
  210. sftp-glob.c
  211. sftp-realpath.c
  212. sftp-server-main.c
  213. sftp-server.8
  214. sftp-server.c
  215. sftp.1
  216. sftp.c
  217. sftp.h
  218. sk-api.h
  219. sk-usbhid.c
  220. smult_curve25519_ref.c
  221. sntrup4591761.c
  222. sntrup4591761.sh
  223. ssh-add.1
  224. ssh-add.c
  225. ssh-agent.1
  226. ssh-agent.c
  227. ssh-dss.c
  228. ssh-ecdsa-sk.c
  229. ssh-ecdsa.c
  230. ssh-ed25519-sk.c
  231. ssh-ed25519.c
  232. ssh-gss.h
  233. ssh-keygen.1
  234. ssh-keygen.c
  235. ssh-keyscan.1
  236. ssh-keyscan.c
  237. ssh-keysign.8
  238. ssh-keysign.c
  239. ssh-pkcs11-client.c
  240. ssh-pkcs11-helper.8
  241. ssh-pkcs11-helper.c
  242. ssh-pkcs11.c
  243. ssh-pkcs11.h
  244. ssh-rsa.c
  245. ssh-sandbox.h
  246. ssh-sk-client.c
  247. ssh-sk-helper.8
  248. ssh-sk-helper.c
  249. ssh-sk.c
  250. ssh-sk.h
  251. ssh-xmss.c
  252. ssh.1
  253. ssh.c
  254. ssh.h
  255. ssh2.h
  256. ssh_api.c
  257. ssh_api.h
  258. ssh_config
  259. ssh_config.5
  260. sshbuf-getput-basic.c
  261. sshbuf-getput-crypto.c
  262. sshbuf-io.c
  263. sshbuf-misc.c
  264. sshbuf.c
  265. sshbuf.h
  266. sshconnect.c
  267. sshconnect.h
  268. sshconnect2.c
  269. sshd.8
  270. sshd.c
  271. sshd_config
  272. sshd_config.5
  273. sshd_config.android
  274. ssherr.c
  275. ssherr.h
  276. sshkey-xmss.c
  277. sshkey-xmss.h
  278. sshkey.c
  279. sshkey.h
  280. sshlogin.c
  281. sshlogin.h
  282. sshpty.c
  283. sshpty.h
  284. sshsig.c
  285. sshsig.h
  286. sshtty.c
  287. start-ssh
  288. survey.sh.in
  289. TODO
  290. ttymodes.c
  291. ttymodes.h
  292. uidswap.c
  293. uidswap.h
  294. umac.c
  295. umac.h
  296. umac128.c
  297. utf8.c
  298. utf8.h
  299. verify.c
  300. version.h
  301. xmalloc.c
  302. xmalloc.h
  303. xmss_commons.c
  304. xmss_commons.h
  305. xmss_fast.c
  306. xmss_fast.h
  307. xmss_hash.c
  308. xmss_hash.h
  309. xmss_hash_address.c
  310. xmss_hash_address.h
  311. xmss_wots.c
  312. xmss_wots.h
README.md

Portable OpenSSH

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, and zlib. libcrypto from either LibreSSL or OpenSSL may also be used, but OpenSSH may be built without it supporting a subset of crypto algorithms.

FIDO security token support need 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.

FlagMeaning
--with-pamEnable PAM support. OpenPAM, Linux PAM and Solaris PAM are supported.
--with-libeditEnable libedit support for sftp.
--with-kerberos5Enable Kerberos/GSSAPI support. Both Heimdal and MIT Kerberos implementations are supported.
--with-selinuxEnable SELinux support.
--with-security-key-builtinInclude 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.