Coreutils - GNU core utilities

Introduction to Coreutils

The GNU Core Utilities are the basic file, shell and text manipulation utilities of the GNU operating system.
These are the core utilities which are expected to exist on every operating system.

Getting Help

Check Questions and Answers for common problems: Coreutils FAQ
Read the manual locally using info coreutils or see the latest online manual (日本語)
The Coreutils Gotchas contains a list of some quirks and unexpected behaviour (which are often mistaken for bugs).
Search the archives for previous questions and answers:
- (Search tips)
- General usage and advice: coreutils Mailing list
- Bug reports: bug-coreutils Mailing List
Send general questions or suggestions to the mailing list at: [email protected]
Send translation requests to the language team linked from: https://translationproject.org/domain/coreutils.html
Report bugs, including version and distribution variant, to the list at: [email protected]
Before sending the bug, please consult the FAQ and Mailing list archives (above).
Often these perceived bugs are simply due to wrong program usage.
To learn more about reporting bugs, see Getting help with GNU software

Downloads

Stable source releases can be found at https://ftp.gnu.org/gnu/coreutils/ (FTP) (local mirrors)
Test source releases can be found at https://alpha.gnu.org/gnu/coreutils/

Source Code

The latest source with revision history can be browsed using cgit, gitweb or GitHub
Assuming you have git installed, you can retrieve the latest version with this command: git clone git://git.sv.gnu.org/coreutils
A coreutils code structure overview is available, which is useful for educational purposes, or for those interested in contributing changes.
To build from the latest sources please follow the instructions in README-hacking
Please note that we do not suggest using test versions of Coreutils for production use.

Third party testing resources

Mailing Lists

You do not need to be subscribed in order to post messages to any GNU mailing list. However non-subscribers are moderated by humans so please be patient when waiting for your email to arrive.

You can subscribe to any GNU mailing list via the web as described below. Or you can send an empty mail with a Subject: header line of just "subscribe" to the relevant -request list. For example, to subscribe yourself to the main coreutils list, you would send mail to [email protected] with no body and a Subject: header line of just "subscribe".

It has been necessary to moderate the Coreutils mailing lists to prevent the flood of spam. Postings to the lists are held for release by the list moderator. Sometimes the moderators are unavailable for brief periods of time. Please be patient when posting. If you don't eventually see the message in the list archive then it did not get posted.

Announcements

The low-volume mailing list <[email protected]> contains all announcements about Coreutils.

Important announcements about Coreutils and most other GNU Software are also made on <[email protected]>.

There are also periodic summaries of committed, rejected and pending changes, to which one can subscribe.

Discussion List

The main discussion list for all things related to coreutils is <[email protected]>. This is a recent change as previously general discussion took place on the bug list. If you have questions, comments, or other general discussion about coreutils then this is the mailing list for that discussion. If you don't know where to start then this is the place to start. You can browse and search past postings to the coreutils archive. Discussion prior to its creation in March 2010 is available in the bug mailing list archive.

Bug Reports

If you think you have found a bug in Coreutils, then please send as complete a bug report as possible to <[email protected]>, and it will automatically be entered into the Coreutils bug tracker. Before reporting bugs please read the FAQ. A very useful and often referenced guide on how to write bug reports and ask good questions is the document How To Ask Questions The Smart Way . You can browse previous postings and search the bug-coreutils archive.

Enhancement Requests

If you would like any new feature to be included in future versions of Coreutils, please send a request to <[email protected]>. This is the general discussion list and a good place to start discussion of a new feature. After consideration you may be asked to log a request into the bug tracker so that the issue is not lost. If you would like to implement yourself, then note that non trivial changes require copyright assignment to the FSF as detailed in the "Copyright Assignment" section of the coreutils HACKING notes. Note also the list of rejected feature requests.

Mailing List Etiquette

Please do not send messages encoded as HTML nor encoded as base64 MIME nor included as multiple formats. Please send messages as plain text. Please include a descriptive subject line. If all of the subjects are bug then it is impossible to differentiate them. Please avoid sending large messages, such as log files, system call trace output, and other content resulting in messages over about 40 kB, to the mailing lists without prior contact. Those are best sent directly to those requesting that information after initial contact.

Please remember that development of Coreutils is a volunteer effort, and you can also contribute to its development. For information about contributing to the GNU Project, please read How to help GNU.

Previous Mailing Lists

Previously these utilities were offered as three individual sets of GNU utilities, Fileutils, Shellutils, and Textutils. Those three were combined into the single set of utilities called Coreutils.

Since coreutils had existed as the three individual packages for a long time you may want to read the archives of those previous mailing lists. Fileutils archive, Shellutils archive, Textutils archive.

Maintainers

Coreutils is currently being maintained by Jim Meyering [email protected], Pádraig Brady [email protected], Bernhard Voelker [email protected], Eric Blake [email protected], Paul Eggert [email protected] and Assaf Gordon [email protected].