The worst implementations of some userland utilities, created by Will Rosecrans for educational purposes.
Not intended for production use.
This software is released under the Apache 2 license.
Released in conjunction with a talk at the SoCal Linux Expo, "Lost in Userland" : https://www.socallinuxexpo.org/scale/17x/presentations/lost-userland
A blog post with a link to the slides is at https://willrosecrans.wordpress.com/2019/03/09/lost-in-userland-talk-at-scale17x/
Scroll down a bit if you want to skip over the history lesson and get straight to build and run instructions.
Everybody knows about the kernel and the applications, but the userland never gets any love. The Kernel is all the scary bits of an OS that talk directly to the hardware, and do Serious Business. People pay attention to big useful Applications on a desktop computer like a GUI word processor or a fancy 3D modelling program. On a server system, web server software like Apache or Nginx on a server get all of the attention. But the bits in the middle that are so important seem to get forgotten.
All of the little commands like 'ls' and 'cp' are completely necessary for you do do important work to get to your big important Applications that you use all day, and collectively they are called the userland.
UNIX style CLI Utilities, a brief history
In the 1940's, long before UNIX, people wrote machine code. Or rather, they toggled machine code in on switches, or wired it up on plugboards. In the 1950's, "Autocoding" was invented so that you could easily write totally intuitive looking software like
c@VA t@IC x@½C y@RC z@NC INTEGERS +5 →c
It may not look terribly friendly to modern eyes. But it was certainly more convenient than physically wiring up plugboard programs. As the 50's rolled on, higher level languages like FORTRAN enabled the use of algebraic notation for calculations. The 1960's brought timesharing systems and interactive 'glass' terminals for computers that had early command line interfaces as we would think of them today. Some were advertised as being able to "speak and understand English" because the commands were English words. ( This advertisement is from 1978 and they were still thrilled with the idea of typing in commands on an interactive terminal https://www.youtube.com/watch?v=I74sVdw7gkc )
UNIX was created in the 1970's, and brought the first generation of C and a suite of tools, API's, and UI idioms that are still with us today. Historically, the earliest implementations of the UNIX userland utilities were mainly written in assembly: https://github.com/jserv/unix-v1/tree/master/src/cmd
By the 1980's, UNIX had grown up and spread out to many different architectures and kinds of hardware so the utilities were largely implemented in portable C, for example in BSD 2.9 from 1983 at the Unix Heritage Society: https://minnie.tuhs.org/cgi-bin/utree.pl?file=2.9BSD/usr/src/cmd/ls
The release of Linux in 1991 invigorated a push for new GPL versions of the userland utilities that were unshackled from the then-dominant commercial UNIX vendors. Higher level and more modern languages like C++ were becoming popular during the 1990's. Exciting development projects like NeXT, BeOS, and Taligent were pushing modern language features into new Operating Systems. The Taligent API's seemed especially keen to show off the fact that modern computers could (and should!) display more than 80 columns of text with verbose names like TaligentTypeExtensionTemplateDeclarationsMacro_Abstract (No, seriously. That name isn't even a joke. Here's some Taligent sample code: https://root.cern.ch/TaligentDocs/TaligentOnline/DocumentRoot/1.0/Docs/samples/Supported/Enablers/AtomicModel/AtomicModel.h from https://root.cern.ch/TaligentDocs/TaligentOnline/DocumentRoot/1.0/Docs/index.html ) BeOS encouraged people to migrate past the traditional Posix API's not just for things like UI and Windowing, but also for basic file manipulation using the BFile class instead of posix open() and close() https://www.haiku-os.org/legacy-docs/programming_the_be_operating_system.pdf (see p. 360 for the section on files.) Similarly, NeXT was pushing for adoption of a class library based on NSObject using Objective C.
So in that time of excitement and revolution during the 1990's, GNU implemented their coreutils for Linux in C, because the honestly design of this stuff had mostly ossified in the 1980's. None of those other 90's projects really went anywhere, so you can't blame them. (Yes, The NS API's were used on OS-X, but they never became pervasive enough to displace the use of classic BSD userland utilities, using Posix and BSD API's under the hood.)
UNIX style CLI Utilities, from scratch
Being a very boring sort of person, I decided to do my own implementation of some traditional UNIX utilities to get a better appreciation of how they work.
I am using C++ as the main language. It's considered low-level but portable, filling about the same niche that C filled in the 1980's. Higher level languages like Python are certainly fast enough for many uses these days, and I am quite fond of Python. But I would feel like I was cheating if I used a language that depended on a large and complicated interpreter or VM, so I am using a language that produces normal, native binaries that can be directly executed with no major dependencies. (Except maybe a few shared libraries.)
Building and running
Building depends on a modern C++ compiler, and CMake 3.5. You'll need Boost, because std::filesystem from C++ 17 is still too hard to use on many systems despite the fact that I am writing this in 2019.
Building with CMake is straightforward, if you are lucky.
mkdir build && cd build cmake .. cmake build .
If you are unlucky, you may wish to consult some CMake documentation: https://izzys.casa/2019/02/everything-you-never-wanted-to-know-about-cmake/ Or not. Nothing makes you appreciate old-school Makefiles like reading CMake documentation.
I am very lazy, and these are simple proof-of-concept utilities for demonstration purposes. I am making no effort to be fully compliant with all your favorite Posix or GNU command line flags. Some modern C++ language features make parts of the code much shorter and easier to write that the classical implementations. (And thus, probably easier to read. Brevity FTW) They do just enough to make for an interesting comparison with GNU and BSD utilities.
I have also adopted a simple mechanism for pluggable implementations to simplify benchmarking if you want to try something different. Just add your function to the "methods" object in main() for cp or ls by adding
methods["foo"] = name_of_my_function;
And it will automatically start appearing in the output of
ls --help and be selectable with
ls --method foo
So if you want to hack on it with some other variations of implementation details, it may be a more convenient place to test out an idea than the more complex GNU coreutils versions.
License for the code in this repository
Copyright 2019, Will Rosecrans
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.