mirror of
https://github.com/dredx/prole.git
synced 2026-09-24 19:14:33 +00:00
909e92109e
- Introduce lib/shell helpers and keep etc/* scripts thin via compatibility shims - Move Kerberos validation to scripts/validation/check_kerberos.sh and update callers - Add deterministic shellspec unit tests under tests/shellspec/ and wire Maven to run them - Add minimal Spring Boot authority module with startup + /health endpoint and Maven wiring - Document the new layout in docs/layout.md Co-authored-by: Junie <junie@jetbrains.com>
222 lines
11 KiB
Markdown
222 lines
11 KiB
Markdown
# Shells
|
|
|
|
- [Tested shells and versions](#tested-shells-and-versions)
|
|
- [Packages](#packages)
|
|
- [Alpine / BusyBox / OpenWrt (LEDE)](#alpine--busybox--openwrt-lede)
|
|
- [CentOS / Fedora](#centos--fedora)
|
|
- [Debian / Ubuntu](#debian--ubuntu)
|
|
- [FreeBSD](#freebsd)
|
|
- [macOS](#macos)
|
|
- [Windows](#windows)
|
|
- [Self build](#self-build)
|
|
- [Schily Bourne Shell](#schily-bourne-shell)
|
|
- [GWSH shell](#gwsh-shell)
|
|
- [Manual test](#manual-test)
|
|
- [Solaris](#solaris)
|
|
- [OpenBSD / NetBSD](#openbsd--netbsd)
|
|
- [AIX](#aix)
|
|
- [Confirmation for bug](#confirmation-for-bug)
|
|
- [Built-in commands](#built-in-commands)
|
|
|
|
## Tested shells and versions
|
|
|
|
- The shell included with the supported OS (the platform in bold) is the main supported shell.
|
|
- Support for very old shells may be discontinued without notice.
|
|
- The version with a dash does not work.
|
|
- The version in italic may work, but some features are not working or unstable due to bugs in the shell.
|
|
- Bourne shell (pre-POSIX shell) is not supported.
|
|
|
|
### Packages
|
|
|
|
- These are tested by [GitHub Actions][actions], [Travis CI][travis], [Cirrus CI][cirrus] and Docker (`contrib/test_in_docker.sh`).
|
|
|
|
[actions]: https://github.com/shellspec/shellspec/actions
|
|
[travis]: https://travis-ci.org/shellspec/shellspec
|
|
[cirrus]: https://cirrus-ci.com/github/shellspec/shellspec
|
|
|
|
#### Alpine / BusyBox / OpenWrt (LEDE)
|
|
|
|
Default shell: `busybox ash`
|
|
|
|
| Platform | bash | busybox | dash | loksh | mksh | oksh | yash | zsh |
|
|
| ------------------- | ------ | -------- | ---- | ----- | ---- | ----- | ---- | --- |
|
|
| **Alpine 3.12.3** | 5.0.17 | 1.31.1 | | 6.7.1 | | | - | |
|
|
| Alpine edge | | | | 6.8.1 | | 6.8.1 | - | |
|
|
| **BusyBox 1.32.0** | - | 1.32.0 | - | - | - | | - | - |
|
|
| LEDE 17.01.7 | | 1.25.1 | - | - | | | - | |
|
|
| OpenWrt 10.03.1 | | _1.15.3_ | | - | | | - | - |
|
|
| OpenWrt 12.09 | | _1.19.4_ | | - | | | - | - |
|
|
| OpenWrt 14.07 | | 1.22.1 | | - | | | - | |
|
|
| OpenWrt 15.05.1 | | 1.23.2 | - | - | | | - | |
|
|
| **OpenWrt 18.06.9** | | 1.28.4 | - | - | | | - | |
|
|
| **OpenWrt 19.07.5** | | 1.30.1 | - | - | | | - | |
|
|
|
|
- _busybox 1.15.3, 1.19.4_: `readonly` is not working properly.
|
|
- `busybox hush` not supported.
|
|
|
|
#### CentOS / Fedora
|
|
|
|
Default shell: `bash`
|
|
|
|
| Platform | bash | busybox | dash | ksh | mksh | yash | zsh |
|
|
| ------------------- | ------ | ------- | ---- | --- | ---- | ---- | ----- |
|
|
| **CentOS 7.9.2009** | 4.2.46 | - | - | | | - | |
|
|
| **CentOS 8.3.2011** | 4.4.19 | - | - | | | - | 5.5.1 |
|
|
| **fedora 32** | 5.0.11 | | | | | | |
|
|
| **fedora 33** | 5.0.17 | | | | | | |
|
|
|
|
- Testing bash 3.2.25- in POSIX mode only.
|
|
|
|
#### Debian / Ubuntu
|
|
|
|
Default shell: `dash` or `bash` (until debian 5.0)
|
|
|
|
| Platform | bash | busybox | dash | ksh93 | ksh2020 | mksh | pdksh | posh | yash | zsh |
|
|
| ---------------- | ------ | ---------- | ------------- | --------------- | -------- | ---- | -------- | -------- | ---- | ------- |
|
|
| Debian 2.2r7 | 2.03 | - | - | - | - | - | _5.2.14_ | - | - | 3.1.9 |
|
|
| Debian 3.0r6 | 2.05a | ~~0.60.2~~ | ~~ash 0.3.8~~ | - | - | - | 5.2.14 | - | - | 4.0.4 |
|
|
| Debian 3.1r8 | 2.05b | ~~0.60.5~~ | 0.5.2 | _93q_ | - | - | 5.2.14 | 0.3.14 | - | _4.2.5_ |
|
|
| Debian 4.0r9 | 3.1.17 | _1.1.3_ | _0.5.3_ | _93r_ | - | R28 | 5.2.14 | 0.5.4 | - | 4.3.2 |
|
|
| Debian 5.0.10 | 3.2.39 | _1.10.2_ | 0.5.4 | 93s+ 2008-01-31 | - | R35 | 5.2.14 | 0.6.13 | - | 4.3.6 |
|
|
| Debian 6.0.10 | 4.1.5 | 1.17.1 | 0.5.5.1 | 93s+ 2008-01-31 | - | R39 | 5.2.14 | _0.8.5_ | - | 4.3.10 |
|
|
| Debian 7.11 | 4.2.37 | 1.20.0 | 0.5.7 | 93u+ 2012-02-29 | - | R40 | - | _0.10.2_ | 2.30 | 4.3.17 |
|
|
| Debian 8.11 | 4.3.30 | 1.22.0 | 0.5.7 | 93u+ 2012-08-01 | - | R50d | - | 0.12.3 | 2.36 | 5.0.7 |
|
|
| **Debian 9.13** | 4.4.12 | 1.22.0 | 0.5.8 | 93u+ 2012-08-01 | - | R54 | - | 0.12.6 | 2.43 | 5.3.1 |
|
|
| **Debian 10.7** | 5.0.3 | 1.30.1 | 0.5.10.2 | 93u+ 2012-08-01 | - | R57 | - | 0.13.2 | 2.48 | 5.7.1 |
|
|
| Debian bullseye | 5.1.0 | | 0.5.11 | 93u+ 2012-08-01 | - | R59c | - | 0.14.1 | 2.50 | 5.8 |
|
|
| Ubuntu 12.04 | 4.2.25 | 1.18.5 | 0.5.7 | 93u 2011-02-08 | - | R40 | - | _0.10_ | 2.29 | 4.3.17 |
|
|
| **Ubuntu 14.04** | 4.3.11 | 1.21.0 | 0.5.7 | 93u+ 2012-08-01 | - | R46 | - | 0.12.3 | 2.35 | 5.0.2 |
|
|
| **Ubuntu 16.04** | 4.3.48 | 1.22.0 | 0.5.8 | 93u+ 2012-08-01 | - | R52c | - | 0.12.6 | 2.39 | 5.1.1 |
|
|
| **Ubuntu 18.04** | 4.4.20 | 1.27.2 | 0.5.8 | 93u+ 2012-08-01 | - | R56c | - | 0.13.1 | 2.46 | 5.4.2 |
|
|
| **Ubuntu 20.04** | 5.0.16 | 1.30.1 | 0.5.10.2 | 93u+ 2012-08-01 | 2020.0.0 | R58 | - | 0.13.2 | 2.49 | 5.8 |
|
|
|
|
- Use [debian/eol](https://hub.docker.com/r/debian/eol) docker images for older Debian versions.
|
|
- Testing bash 2.03-3.2.39 in both POSIX and non-POSIX mode. bash 4.1.5- is non-POSIX mode only.
|
|
- _pdksh 5.2.14_ (Debian 2.2.r7): `readonly` is not working properly.
|
|
- _ksh 93q, 93r_: Sometimes abort due to unstable bugs.
|
|
- _busybox 1.1.3_: Builtin commands cannot be mocked.
|
|
- _busybox 1.10.2_: It may not work properly due to a bug.
|
|
- _posh 0.8.5_: Signal handling (`trap`) broken.
|
|
- _posh 0.10, 0.10.2_: Shell flags (e.g. `set -e`, `set -u`) not working properly.
|
|
- _zsh 4.2.5_: errexit handling broken.
|
|
|
|
#### FreeBSD
|
|
|
|
Default shell: `ash`
|
|
|
|
| Platform | FreeBSD sh | bash | dash | ksh | mksh | oksh | pdksh | zsh |
|
|
| ---------------- | ---------- | ------ | -------- | --------------- | ---- | -------- | -------- | ----- |
|
|
| FreeBSD 10.4 | unknown | 4.4.23 | 0.5.10.2 | 93u+ 2012-08-01 | R56c | 20181009 | _5.2.14_ | 5.6.2 |
|
|
| **FreeBSD 11.4** | unknown | 5.0.18 | 0.5.10.2 | 93u+ 2012-08-01 | R59b | 6.7 | _5.2.14_ | 5.8 |
|
|
| **FreeBSD 12.2** | unknown | 5.0.18 | 0.5.10.2 | 93u+ 2012-08-01 | R59b | 6.7 | _5.2.14_ | 5.8 |
|
|
|
|
- _pdksh 5.2.14_: Unstable on CI environment (Bus Error, Bad address, Memory fault, core dumped and etc).
|
|
|
|
#### macOS
|
|
|
|
Default shell: `bash`
|
|
|
|
| Platform | sh | bash | dash | ksh | mksh | posh | yash | zsh |
|
|
| ---------------------- | ----------- | ------ | -------- | --------------- | ---- | ---------- | ---- | ----- |
|
|
| macOS 10.10 | bash 3.2.57 | 3.2.57 | - | 93u+ 2012-08-01 | - | - | - | 5.0.5 |
|
|
| macOS 10.11 | bash 3.2.57 | 3.2.57 | - | 93u+ 2012-08-01 | - | - | - | 5.0.8 |
|
|
| macOS 10.12 | bash 3.2.57 | 3.2.57 | - | 93u+ 2012-08-01 | - | - | - | 5.2 |
|
|
| macOS 10.13 | bash 3.2.57 | 3.2.57 | - | 93u+ 2012-08-01 | - | - | - | 5.3 |
|
|
| **macOS 10.14** | bash 3.2.57 | 3.2.57 | - | 93u+ 2012-08-01 | - | - | - | 5.3 |
|
|
| **macOS 10.15** | bash 3.2.57 | 3.2.57 | - | 93u+ 2012-08-01 | - | - | - | 5.7.1 |
|
|
| **macOS 10.16** | bash 3.2.57 | 3.2.57 | - | 93u+ 2012-08-01 | - | - | - | 5.8 |
|
|
| **macOS 10.15 (brew)** | - | 5.1.0 | 0.5.11.2 | 2020.0.0 | R59b | ~~0.14.1~~ | 2.50 | 5.8 |
|
|
|
|
- Supports the latest three versions.
|
|
- Homebrew version of posh is broken.
|
|
|
|
#### Windows
|
|
|
|
Default shell: `bash`
|
|
|
|
| Platform | bash | busybox | dash | mksh | posh | zsh |
|
|
| ------------------------------------- | ------ | --------------- | -------- | ---- | ------ | --- |
|
|
| **Windows Server 2019 (Git Bash)** | 4.4.23 | - | unknown | - | - | - |
|
|
| **Windows Server 2019 (msys)** | 4.4.23 | 1.31.1 | 0.5.11.2 | R59 | - | 5.8 |
|
|
| **Windows Server 2019 (cygwin)** | 4.4.12 | 1.23.2 | 0.5.9.1 | R56c | 0.13.2 | 5.8 |
|
|
| **Windows Server 2019 (busybox-w32)** | - | 1.33.0 (3578.0) | - | - | - | - |
|
|
|
|
- busybox-w32: [https://frippery.org/busybox/](https://frippery.org/busybox/)
|
|
|
|
### Self build
|
|
|
|
These are tested by Docker (`contrib/test_in_docker.sh`).
|
|
|
|
#### Schily Bourne Shell
|
|
|
|
| Platform | Schily versions | bosh / pbosh |
|
|
| ------------- | ----------------------------- | ------------ |
|
|
| Debian buster | AN-2018-10-30 | 2018/10/07 |
|
|
| Debian buster | AN-2019-03-11 | 2019/02/05 |
|
|
| Debian buster | AN-2019-09-22 | 2019/08/25 |
|
|
| Debian buster | AN-2019-10-07 | 2019/09/27 |
|
|
| Debian buster | AN-2019-10-25 - AN-2019-12-05 | 2019/10/25 |
|
|
| Debian buster | AN-2020-02-11 - AN-2020-03-11 | 2020/01/24 |
|
|
| Debian buster | AN-2020-03-27 | 2020/03/25 |
|
|
| Debian buster | AN-2020-04-18 | _2020/04/10_ |
|
|
| Debian buster | AN-2020-05-11 - AN-2020-08-12 | 2020/04/27 |
|
|
| Debian buster | AN-2020-09-04 - AN-2020-09-22 | 2020/09/03 |
|
|
| Debian buster | AN-2020-11-04 - AN-2020-11-25 | 2020/11/04 |
|
|
|
|
- [Schily Bourne Shell][bosh] (`bosh`, `pbosh`)
|
|
- Packages are available on [The NetBSD package collection][pkgsrc].
|
|
- Versions before 2018/10/07 not tested (probably not working).
|
|
- _2020/04/10_: errexit handling broken.
|
|
|
|
[bosh]: http://schilytools.sourceforge.net/bosh.html
|
|
[pkgsrc]: http://pkgsrc.se/shells/bosh
|
|
|
|
#### GWSH shell
|
|
|
|
| Platform | gwsh |
|
|
| ------------- | ----------------- |
|
|
| Debian buster | snapshot-20190627 |
|
|
|
|
- [GWSH shell](https://github.com/hvdijk/gwsh/releases)
|
|
|
|
### Manual test
|
|
|
|
This is not continuous test, it may break sometimes...
|
|
|
|
- \* Reported by user
|
|
|
|
#### Solaris
|
|
|
|
| Platform | /bin/sh | /usr/bin/ksh | /usr/sunos/bin/ksh | /usr/sunos/bin/sh |
|
|
| -------------- | --------------------- | ------------------- | ------------------- | ----------------- |
|
|
| **Solaris 10** | ~~Bourne Shell~~ | _ksh88 M-11/16/88i_ | - | - |
|
|
| **Solaris 11** | ksh93 93u+ 2012-08-01 | - | _ksh88 M-11/16/88i_ | ~~Bourne Shell~~ |
|
|
|
|
- _ksh88 M-11/16/88i_: Builtin commands cannot be mocked.
|
|
|
|
#### OpenBSD / NetBSD
|
|
|
|
| Platform | /bin/sh | /usr/bin/ksh |
|
|
| ------------------ | ---------------------------------------- | ------------ |
|
|
| FreeBSD 13 current | FreeBSD sh | - |
|
|
| **OpenBSD 6.6** | OpenBSD ksh (POSIX mode pdksh) 5.2.14 | pdksh 5.2.14 |
|
|
| **NetBSD 9.0** | NetBSD sh 20181212 BUILD:20200214000628Z | pdksh 5.2.14 |
|
|
|
|
#### AIX
|
|
|
|
| Platform | Shells |
|
|
| ------------- | ----------- |
|
|
| AIX 7.2.1.4 * | bash 4.3.30 |
|
|
|
|
## Confirmation for bug
|
|
|
|
`contrib/bugs.sh` detects shell bugs and problems.
|
|
|
|
Usage: `contrib/bugs.sh`
|
|
|
|
## Built-in commands
|
|
|
|
`contrib/builtins.sh` is a script for listing built-in commands.
|
|
|
|
Usage: `contrib/builtins.sh`
|