Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

As noted in commit 2d848eb (ash: fix CRLF handling) all CRs are
removed when scripts are read.  Allow an alternative approach
(configurable at build-time, enabled by default):

- Do not strip CRs from input.

- Treat CR as similar to space or tab in base syntax mode.

- Adjust pgetc_eatbnl() to handle backslash-CRLF in the same way
  as backslash-LF.

With these changes scripts containing CRLF line endings are more
likely to work.

Adds 48-56 bytes.

(GitHub issue #285)


Failed to load latest commit information.
Latest commit message
Commit time
February 7, 2023 10:03
May 2, 2022 14:25
August 30, 2022 16:41
January 5, 2023 08:57
May 2, 2022 14:47
February 4, 2023 08:16
February 9, 2022 09:05
August 30, 2022 16:41
May 1, 2022 17:06
February 7, 2023 10:03
January 30, 2023 12:24
January 30, 2023 12:24
June 30, 2022 17:18
April 17, 2012 12:28
January 14, 2018 14:41
November 9, 2022 16:39
July 29, 2017 17:30
January 31, 2010 05:15


Things may work for you, or may not. Things may never work because of huge differences between Linux and Windows. Or things may work in future, if you report the problem on GitHub or GitLab. If you don't have an account on one of those or you'd prefer to communicate privately you can email

Additional information and downloads of precompiled binaries are available from


You need a MinGW compiler and a POSIX environment. I cross-compile on Linux. On Fedora the following should pull in everything required:

dnf install gcc make ncurses-devel perl-Pod-Html

dnf install mingw64-gcc mingw64-windows-default-manifest (for a 64-bit build)

dnf install mingw32-gcc mingw32-windows-default-manifest (for a 32-bit build)

On Microsoft Windows you can install w64devkit. The -mini variant is sufficient. Get the -i686 variant for a 32-bit build. Unzip the file and run w64devkit/w64devkit.exe.

On either Linux or Windows the commands make mingw64_defconfig or make mingw32_defconfig will pick up the default configuration. You can then customize your build with make menuconfig or by editing .config, if you know what you're doing.

Then just make.


  • Use forward slashes in paths: Windows doesn't mind and the shell will be happier.
  • Windows paths are different from Unix (more detail):
    • Absolute paths: c:/path or //host/share
    • Relative to current directory of other drive: c:path
    • Relative to current root (drive or share): /path
    • Relative to current directory of current root (drive or share): path
  • Handling of users, groups and permissions is totally bogus. The system only admits to knowing about the current user and always returns the same hardcoded uid, gid and permission values.
  • Some crufty old Windows code (Windows XP, cmd.exe) doesn't like forward slashes in environment variables. The -X shell option (which must be the first argument) prevents busybox-w32 from changing backslashes to forward slashes. If Windows programs don't run from the shell it's worth trying it.
  • If you want to install 32-bit BusyBox in a system directory on a 64-bit version of Windows you should put it in C:\Windows\SysWOW64, not C:\Windows\System32 as you might expect. On 64-bit systems the latter is for 64-bit binaries.
  • The system tries to detect the best way to handle ANSI escape sequences for the terminal being used. If this doesn't work you can try setting the environment variable BB_SKIP_ANSI_EMULATION=1 to force the use of literal ANSI escapes or BB_SKIP_ANSI_EMULATION=0 to emulate them using the Windows console API.
  • It's possible to obtain pseudo-random numbers using if=/dev/urandom as the input file to dd. The same emulation of /dev/urandom is used internally by the shred utility and to support https in wget. Since the pseudo-random number generator isn't being seeded with sufficient entropy the randomness shouldn't be relied on for any serious use.