busybox
----------------------------------------------------------------------
Tiny utilities in a single executable

Busybox combines tiny versions of many common utilities into a single
executable.

Runtime requirements:
  cygwin

Build requirements:
  binutils
  bzip2
  cygport
  gcc-core
  make

Canonical homepage:
  https://www.busybox.net/

Canonical download:
  https://www.busybox.net/downloads/

Version control repository:
  https://git.busybox.net/busybox/

Mailing lists:
  http://lists.busybox.net/mailman/listinfo/busybox

License:
  GPL-2.0-only

Language:
  C

---------------------------------------------

Port notes:

Allmost all configuration options which work on Cygwin are enabled (see
output of "busybox bbconfig").

The extra busybox-standalone package contains a version compiled with
'standalone shell' feature enabled.  Then the Busybox shell runs any
built-in applets before checking the command path.

Both packages install a symlink to busybox.exe with alternatives(8):
  /usr/bin/busybox -> /usr/libexec/busybox/bin/busybox.exe
  /usr/bin/busybox -> /usr/libexec/busybox-standalone/bin/busybox.exe
If both packages are installed, the non-standalone version takes
precedence.


Usage examples:
- Run some Busybox command (for example the ash shell):

  $ busybox ash
or
  $ /usr/libexec/busybox/bin/ash

- Insert a Busybox command into default PATH (for example dos2unix):

  $ ln -s /usr/bin/busybox /usr/local/bin/dos2unix

- Append all Busybox commands to the end of the PATH:

  $ export PATH="$PATH:/usr/libexec/busybox/bin"

- Create a tiny version of Cygwin:

  $ cp -a /usr/libexec/busybox /some/where/busybox
or
  $ cp -a /usr/libexec/busybox-standalone /some/where/busybox

  $ cp -p /bin/cygwin1.dll /some/where/busybox/bin

Add terminal emulator (recommended):
  $ cp -p /bin/mintty.exe /some/where/busybox/bin

Add Cygwin specific tools (optional):
  $ cp -p /bin/cygpath.exe /bin/mkpasswd.exe .... /some/where/busybox/bin


Known issues and limitations:
- 'cp', 'install', 'ln' and 'mv' do not provide any automatic handling of
names with a '.exe' suffix.

- 'df' does not recognize Cygwin mount information.

- 'nslookup' always uses default Windows DNS server settings.
The /etc/resolv.conf file and the SERVER parameter are ignored.

- 'ping', 'ping6' and 'traceroute' require admin rights before Win10 1703.

- 'traceroute' only supports ICMPv4.  The -I option is required.
To see intermediate hops, ICMPv4 incoming must be enabled in Windows firewall.

- 'mpstat', 'nmeter' and 'top' do not provide all info due to limitations of
Cygwin /proc filesystem.


--------  busybox-1.36.1-1  -- 2023-09-15 --------
busybox 1.36.1  2023-05-19

--------  busybox-1.23.2-1  -- 2015-07-05 --------
First experimental release for Cygwin.
busybox 1.23.2  2015-03-23


For more information about this package, see the upstream documentation in
/usr/share/doc/busybox.

Cygwin port by: Christian Franke.

Please address all questions to the Cygwin mailing list at <cygwin@cygwin.com>.
