fork of vitali64's project: http://git.vitali64.duckdns.org/utils/fases.git/ this fork contains some of my improvements, in the "abyss" branch. the master branch shall mirror vitali64's project

Leah Rowe ae900a6ab1 TODO: ls -R: proper globbing 2 years ago
man 54368c66ff Initial commit 2 years ago
.gitignore 1116b28397 update the .gitignore file 2 years ago
AUTHORS fb15d97bb5 Add an AUTHORS file 2 years ago
COPYING 6e6ffaf5b3 Rename LICENSE to COPYING 2 years ago
Makefile a230deb571 centralized Makefile 2 years ago
README.md a2b184d3f1 readme: document new ls options 2 years ago
TODO ae900a6ab1 TODO: ls -R: proper globbing 2 years ago
cat.c 8999121383 Revert incomplete change to cat.c 2 years ago
date.c 94fa4a06d8 date: removed unused argc/argv from main() 2 years ago
head.c a230deb571 centralized Makefile 2 years ago
ls.c c94712f653 simplified ls -R logic 2 years ago
yes.c a230deb571 centralized Makefile 2 years ago

README.md

fases - Ferass' Base System

Simple coreutils for a fully functionnal UNIX-like system

Goal

The fases project tries to provide friendly, functionnal and simple core utilities for a fully functionnal UNIX-like Operating System. It tries to be entirely portable and working on any UNIX-like Operating System and kernel such as OpenBSD and Linux. It also tries to be completly modular and as such one utility should not depend on another in order to work. The coreutils are still a work-in-progress.

Status

The fases project is still incomplete as some utilities are missing, here's what fases currently provides:

(n: not implemented, i: implemented)

ls:

  • [i] Lists files.

  • [i] -a

  • [i] -A

  • [i] -C

  • [n] Other options.

head:

  • [i] Prints file until a specific line.

  • [i] Defaults to 10.

  • [i] -n NUMBER

cat:

  • [i] Prints file to stdin.

  • [n] -u.

yes:

  • [i] Spams 'y'.

  • [i] Spams any other string specified by the user.

date:

  • [i] Shows date by default.

  • [n] Formats date.

Other utilities are still in the making. Help is greatly appreciated.

Known bugs

The fases project is still a Work-in-progress and as such, there are bugs. Please do report bugs to me, via IRC, email, or even by using Notabug.org issues.

Bug Affected utility/utilities
Weird characters at the end of the output cat

Compile

You have 2 choices:

  • compile each utility separately;

  • compile only fasesiab which includes all utilities in a single binary.

Modify the config.mk file to fit your needs in both cases.

Compiling each utility separately

For example to compile cat, you have to run the following:

$ cd src/cat
$ make

And to install it, you have to run one of the 2 commands:

Run only one of the two commands! 
$ doas make install # Install as /usr/bin/cat
$ doas make install-alongside # Install as /usr/bin/cat-fases

Compiling fasesiab

Fasesiab stands for Ferass' Base System in a box. It includes the entire coreutils in a single and tiny binary.

First, go into the src/fasesiab folder:

$ cd src/fasesiab

Before compiling, you have to generate the main.c file which, prior to the generation, contains nothing.

Run the following to generate the file:

$ make gen

Then verify if it all went successfully by opening the file, the file should now have actual code along with a comment containing the date of generation.

Now you're ready to compile! Run make and get a binary!

$ make

Documentation

Documentation can be found inside the man/ directory; run man to render them. Documentation isn't complete yet though, but most utilities are POSIX-compliant so they should work the same (if the utility is fully implemented of course).