coreutils

Tue, 09 Sep 2025 15:29:32 +0800

uutils/coreutils

uutils coreutils

uutils coreutils is a cross-platform reimplementation of the GNU coreutils in Rust. While all programs have been implemented, some options might be missing or different behavior might be experienced.

To install it:

1
2

cargo install coreutils
~/.cargo/bin/coreutils

Goals

uutils coreutils aims to be a drop-in replacement for the GNU utils. Differences with GNU are treated as bugs.

Our key objectives include:

Matching GNU’s output (stdout and error code) exactly
Better error messages
Providing comprehensive internationalization support (UTF-8)
Improved performances
Extensions when relevant (example: –progress)

uutils aims to work on as many platforms as possible, to be able to use the same utils on Linux, macOS, Windows and other platforms. This ensures, for example, that scripts can be easily transferred between platforms.

Documentation

uutils has both user and developer documentation available:

Both can also be generated locally, the instructions for that can be found in the coreutils docs repository.

Use weblate/rust-coreutils to translate the Rust coreutils into your language.

Requirements

Rust (cargo, rustc)
GNU Make (optional)

Rust Version

uutils follows Rust’s release channels and is tested against stable, beta and nightly. The current Minimum Supported Rust Version (MSRV) is 1.85.0.

Building

There are currently two methods to build the uutils binaries: either Cargo or GNU Make.

Building the full package, including all documentation, requires both Cargo and GNU Make on a Unix platform.

For either method, we first need to fetch the repository:

1
2

git clone https://github.com/uutils/coreutils
cd coreutils

Cargo

Building uutils using Cargo is easy because the process is the same as for every other Rust program:

`1`	`cargo build --release`

This command builds the most portable common core set of uutils into a multicall (BusyBox-type) binary, named ‘coreutils’, on most Rust-supported platforms.

Additional platform-specific uutils are often available. Building these expanded sets of uutils for a platform (on that platform) is as simple as specifying it as a feature:

cargo build --release --features macos
# or ...
cargo build --release --features windows
# or ...
cargo build --release --features unix

If you don’t want to build every utility available on your platform into the final binary, you can also specify which ones you want to build manually. For example:

`1`	`cargo build --features "base32 cat echo rm" --no-default-features`

If you don’t want to build the multicall binary and would prefer to build the utilities as individual binaries, that is also possible. Each utility is contained in its own package within the main repository, named “uu_UTILNAME”. To build individual utilities, use cargo to build just the specific packages (using the --package [aka -p] option). For example:

`1`	`cargo build -p uu_base32 -p uu_cat -p uu_echo -p uu_rm`

GNU Make

Building using make is a simple process as well.

To simply build all available utilities:

make

In release mode:

`1`	`make PROFILE=release`

To build all but a few of the available utilities:

`1`	`make SKIP_UTILS='UTILITY_1 UTILITY_2'`

To build only a few of the available utilities:

`1`	`make UTILS='UTILITY_1 UTILITY_2'`

Installation

Install with Cargo

Likewise, installing can simply be done using:

`1`	`cargo install --path . --locked`

This command will install uutils into Cargo’s bin folder (e.g. $HOME/.cargo/bin).

This does not install files necessary for shell completion or manpages. For manpages or shell completion to work, use GNU Make or see Manually install shell completions/Manually install manpages.

Install with GNU Make

To install all available utilities:

`1`	`make install`

To install using sudo switch -E must be used:

`1`	`sudo -E make install`

To install all but a few of the available utilities:

`1`	`make SKIP_UTILS='UTILITY_1 UTILITY_2' install`

To install only a few of the available utilities:

`1`	`make UTILS='UTILITY_1 UTILITY_2' install`

To install every program with a prefix (e.g. uu-echo uu-cat):

`1`	`make PROG_PREFIX=PREFIX_GOES_HERE install`

To install the multicall binary:

`1`	`make MULTICALL=y install`

Set install parent directory (default value is /usr/local):

1
2

# DESTDIR is also supported
make PREFIX=/my/path install

Installing with make installs shell completions for all installed utilities for bash, fish and zsh. Completions for elvish and powershell can also be generated; See Manually install shell completions.

To skip installation of completions and manpages:

`1`	`make COMPLETIONS=n MANPAGES=n install`

Manually install shell completions

The coreutils binary can generate completions for the bash, elvish, fish, powershell and zsh shells. It prints the result to stdout.

The syntax is:

`1`	`cargo run completion <utility> <shell>`

So, to install completions for ls on bash to /usr/local/share/bash-completion/completions/ls, run:

`1`	`cargo run completion ls bash > /usr/local/share/bash-completion/completions/ls`

Manually install manpages

To generate manpages, the syntax is:

`1`	`cargo run manpage <utility>`

So, to install the manpage for ls to /usr/local/share/man/man1/ls.1 run:

`1`	`cargo run manpage ls > /usr/local/share/man/man1/ls.1`

Un-installation

Un-installation differs depending on how you have installed uutils. If you used Cargo to install, use Cargo to uninstall. If you used GNU Make to install, use Make to uninstall.

Uninstall with Cargo

To uninstall uutils:

`1`	`cargo uninstall coreutils`

Uninstall with GNU Make

To uninstall all utilities:

`1`	`make uninstall`

To uninstall every program with a set prefix:

`1`	`make PROG_PREFIX=PREFIX_GOES_HERE uninstall`

To uninstall the multicall binary:

`1`	`make MULTICALL=y uninstall`

To uninstall from a custom parent directory:

1
2

# DESTDIR is also supported
make PREFIX=/my/path uninstall

GNU test suite compatibility

Below is the evolution of how many GNU tests uutils passes. A more detailed breakdown of the GNU test results of the main branch can be found in the user manual.

See https://github.com/orgs/uutils/projects/1 for the main meta bugs (many are missing).

Contributing

To contribute to uutils, please see CONTRIBUTING.

License

uutils is licensed under the MIT License - see the LICENSE file for details

GNU Coreutils is licensed under the GPL 3.0 or later.

WSL

Fri, 23 May 2025 15:28:31 +0800

microsoft/WSL

Welcome to the Windows Subsystem for Linux (WSL) repository

Learn more about WSL | Downloads & Release notes | Contributing to WSL

About

Windows Subsystem for Linux (WSL) is a powerful way for you to run your Linux command-line tools, utilities and applications, all unmodified and directly on Windows without the overhead of a traditional virtual machine or dual boot setup.

You can install WSL right away by running this command inside of your Windows command line:

`1`	`wsl --install`

You can learn more about best practices for setup, overviews of WSL and more at our WSL documentation page.

WSL also has related open source repositories:

microsoft/WSL2-Linux-Kernel - The Linux kernel shipped with WSL
microsoft/WSLg - Support for Linux GUI apps in WSL
microsoftdocs/wsl - WSL documentation at aka.ms/wsldocs

Contributing

This project welcomes contributions of all types, including coding features / bug fixes, documentation fixes, design proposals and more.

We ask that before you start working on a contribution, please read our Contributor’s Guide.

For guidance on developing for WSL, please read the developer docs for instructions on how to build WSL from source and details on its architecture.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft’s Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.

Privacy and telemetry

The application logs basic diagnostic data (telemetry). For more information on privacy and what we collect, see our data and privacy documentation.

The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft’s privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.

Utilities on Producthunt daily

coreutils

uutils/coreutils

uutils coreutils

Goals

Documentation

Requirements

Rust Version

Building

Cargo

GNU Make

Installation

Install with Cargo

Install with GNU Make

Manually install shell completions

Manually install manpages

Un-installation

Uninstall with Cargo

Uninstall with GNU Make

GNU test suite compatibility

Contributing

License

WSL

microsoft/WSL

Welcome to the Windows Subsystem for Linux (WSL) repository

About

Related repositories

Contributing

Code of Conduct

Trademarks

Privacy and telemetry