Update README formatting.

This commit is contained in:
Mid Favila 2021-07-09 20:35:00 +00:00
parent f4fed2bc63
commit eea3ac2b09

75
README
View File

@ -1,29 +1,66 @@
ACHTUNG! ACHTUNG!
This is my personal set of ports for KISS, a POSIX(ish) meta distribution of *NIX. These packages currently assume a Linux-based system, but support for *BSD will likely arrive in the future. Please report any bugs to me via email; thanks. This is my personal set of ports for KISS, a POSIX(ish) meta distribution of
*NIX. These packages currently assume a Linux-based system, but support for
*BSD will likely arrive in the future. Please report any bugs to me via
email; thanks.
The mbase directory contains symlinks to packages that I install as my core userspace. The mbase directory contains symlinks to packages that I install as my core
userspace.
The banished directory contains software that has been isolated for whatever reason. May or may not include a "JUSTIFICATION" file to remind myself in the future. The banished directory contains software that has been isolated for whatever
reason. May or may not include a "JUSTIFICATION" file to remind myself in the
future.
Note that not all of the packages in this repo are written by me; some are forked from Core and Community. This is purely a matter of convenience. Note that not all of the packages in this repo are written by me; some are
forked from Core and Community. This is purely a matter of convenience.
All packages under mbase have been tested and build on the Haswell microarchitecture using the following CFLAGS (assuming GCC): All packages under mbase have been tested and build on the Haswell
microarchitecture using the following CFLAGS (assuming GCC):
-pipe //Compile in memory -pipe
-w //Suppress errors Compile in memory
-D_FORTIFY_SOURCE=1 //Perform lightweight tests to catch overflows and etc
-O2 //Standard level of optimization -w
-march=native //Compile for the current micro-arch Suppress errors
-fasynchronous-unwind-tables //Use the DWARF format for unwind tables. Reduces ELF size.
-momit-leaf-frame-pointer //Leave out unneeded pointers -D_FORTIFY_SOURCE=1
-ftree-loop-vectorize //Vectorize trees (unsure of the implications, but doesn't appear to cause breakage; will investigate further) Perform lightweight tests to catch overflows and etc
-fstack-protector-strong //Sacrifice a fair amount of performance in order to protect from stack smashing
--param ssp-buffer-size=4 //Increase the number of functions under the stack protector -O2
-fstack-clash-protection //Protect from stack clashing. Will investigate further Standard level of optimization
-fPIE //Generate position-independent executables
-fPIC //Generate position-independent code -march=native
-Wl,--hash-style=gnu //Linker arguments Compile for the current micro-arch
-fasynchronous-unwind-tables
Use the DWARF format for unwind tables. Reduces ELF size
-momit-leaf-frame-pointer
Leave out unneeded pointers
-ftree-loop-vectorize
Vectorize trees (unsure of the implications, but doesn't appear to cause
breakage; will investigate further)
-fstack-protector-strong
Sacrifice a fair amount of performance in order to protect from stack
smashing
--param ssp-buffer-size=4
Increase the number of functions under the stack protector
-fstack-clash-protection
Protect from stack clashing. Will investigate further
-fPIE
Generate position-independent executables
-fPIC
Generate position-independent code
-Wl,--hash-style=gnu
Linker arguments
A new subdir, bin, containing binaries built with the above CFLAGS (sans native) A new subdir, bin, containing binaries built with the above CFLAGS (sans native)
will be added in the future. I, however, encourage you to build from source if will be added in the future. I, however, encourage you to build from source if