Mirror of most important branches of the main Sortix repository
Go to file
Jonas 'Sortie' Termansen 84c0844f56 Seed kernel entropy with randomness from the previous boot.
The bootloader will now load the /boot/random.seed file if it exists, in
which case the kernel will use it as the initial kernel entropy. The kernel
warns if no random seed was loaded, unless the --no-random-seed option was
given. This option is used for live environments that inherently have no
prior secret state. The kernel initializes its entropy pool from the random
seed as of the first things, so randomness is available very early on.

init(8) will emit a fresh /boot/random.seed file on boot to avoid the same
entropy being used twice. init(8) also writes out /boot/random.seed on
system shutdown where the system has the most entropy. init(8) will warn if
writing the file fails, except if /boot is a real-only filesystem, and
keeping such state is impossible. The system administrator is then
responsible for ensuring the bootloader somehow passes a fresh random seed
on the next boot.

/boot/random.seed must be owned by the root user and root group and must
have file permissions 600 to avoid unprivileged users can read it. The file
is passed to the kernel by the bootloader as a multiboot module with the
command line --random-seed.

If no random seed is loaded, the kernel attempts a poor quality fallback
where it seeds the kernel arc4random(3) continuously with the current time.
The timing variance may provide some effective entropy. There is no real
kernel entropy gathering yet. The read of the CMOS real time clock is moved
to an early point in the kernel boot, so the current time is available as
fallback entropy.

The kernel access of the random seed module is supposed to be infallible
and happens before the kernel log is set up, but there is not yet a failsafe
API for mapping single pages in the early kernel.

sysupgrade(8) creates /boot/random.seed if it's absent as a temporary
compatibility measure for people upgrading from the 1.0 release. The GRUB
port will need to be upgraded with support for /boot/random.seed in the
10_sortix script. Installation with manual bootloader configuration will
need to load the random seed with the --random-seed command line. With GRUB,
this can be done with: module /boot/random.seed --random-seed
2016-10-04 00:34:50 +02:00
bench Relicense Sortix to the ISC license. 2016-03-05 22:21:50 +01:00
build-aux Seed kernel entropy with randomness from the previous boot. 2016-10-04 00:34:50 +02:00
carray Fix newlines in errx(3) calls. 2016-10-03 16:00:00 +02:00
disked Fix getline(3) and getdelim(3) usage. 2016-05-15 19:32:04 +02:00
dispd Fix execl(3) sentinel undefined behaviour. 2016-09-30 23:36:49 +02:00
doc Document clock(3) as obsolete. 2016-09-28 20:29:17 +02:00
editor Port the editor to non-sortix operating systems. 2016-05-15 22:43:29 +02:00
ext Fix handling of unmountable filesystems. 2016-03-26 16:07:22 +01:00
games Relicense Sortix to the ISC license. 2016-03-05 22:21:50 +01:00
init Seed kernel entropy with randomness from the previous boot. 2016-10-04 00:34:50 +02:00
kblayout Add keyboard layout collection. 2015-12-19 02:21:15 +01:00
kblayout-compiler Port build utilities to musl. 2016-09-29 00:01:40 +02:00
kernel Seed kernel entropy with randomness from the previous boot. 2016-10-04 00:34:50 +02:00
libc Seed kernel entropy with randomness from the previous boot. 2016-10-04 00:34:50 +02:00
libm Remove libm exec-include directory. 2016-01-25 17:39:57 +01:00
libmount Fix handling of unmountable filesystems. 2016-03-26 16:07:22 +01:00
login Make the branding system more neutral. 2016-05-15 22:43:29 +02:00
mkinitrd Port build utilities to musl. 2016-09-29 00:01:40 +02:00
regress Relicense Sortix to the ISC license. 2016-03-05 22:21:50 +01:00
sf Relicense Sortix to the ISC license. 2016-03-05 22:21:50 +01:00
sh Fix execl(3) sentinel undefined behaviour. 2016-09-30 23:36:49 +02:00
share/man Seed kernel entropy with randomness from the previous boot. 2016-10-04 00:34:50 +02:00
sysinstall Seed kernel entropy with randomness from the previous boot. 2016-10-04 00:34:50 +02:00
tix Port build utilities to musl. 2016-09-29 00:01:40 +02:00
trianglix Fix execl(3) sentinel undefined behaviour. 2016-09-30 23:36:49 +02:00
update-initrd Relicense Sortix to the ISC license. 2016-03-05 22:21:50 +01:00
utils Update cp(1) to current coding conventions. 2016-10-03 20:02:12 +02:00
.gitignore Remove non-existent directories from .gitignore. 2016-03-06 14:55:03 +01:00
LICENSE Relicense Sortix to the ISC license. 2016-03-05 22:21:50 +01:00
Makefile Run the existing sysmerge(8) in the make sysmerge targets. 2016-10-04 00:34:49 +02:00
README Fix 'is can' typo in README. 2016-10-01 14:52:09 +02:00

README

The Sortix Operating System
===========================

Sortix is a small self-hosting operating-system aiming to be a clean and modern
POSIX implementation.  It is a hobbyist operating system written from scratch
with its own base system, including kernel and standard library, as well as
ports of third party software.  It has a straightforward installer and can be
developed under itself.  Releases come with the source code in /src, ready for
tinkering.

It has been in development since 2011 by a single developer and contributors.
Though the system is stable and capable right now, it is still early in
development, and a number of crucial features haven't been made yet.  Releases
are made yearly and future releases will add features such as networking, SMP,
and USB that were skipped in favor of becoming self-hosting now.

Documentation
-------------

The system is documented as manual pages.  Introductory system usage is covered
in the user-guide(7) manual page.

Links
-----

For more information, please visit the official website:

  https://sortix.org/

Building Sortix
---------------

Development of Sortix under itself is covered in development(7).

Development from another operating system is covered in cross-development(7).

You can view the cross-development(7) manual page with this command:

  man share/man/man7/cross-development.7

License
-------

Copyright 2011-2016 Jonas 'Sortie' Termansen and contributors.

Sortix is free software licensed under the ISC license as described in the
LICENSE file.  It also contains permissively licensed code from other projects.