Operating system for OpenComputers

XeonSquared c0f8b9b900 attempt to load pkgfs if there's a package archive directory		10ヶ月前
cfg	update to match latest diskpart	10ヶ月前
kcfg	refactor build system to allow pulling libraries from packages, assuming directories are set up correctly	10ヶ月前
lib	fix edge case where io.open(whatever):read() returns nil	10ヶ月前
module	attempt to load pkgfs if there's a package archive directory	10ヶ月前
service	moved fserv to its own package	10ヶ月前
.editorconfig	clipboard: Make the clipboard service work under the new service sys	4年前
.gitignore	clipboard: Make the clipboard service work under the new service sys	4年前
LICENSE	Initial commit	5年前
README.md	update to match latest diskpart	10ヶ月前
build.lua	refactor build system to allow pulling libraries from packages, assuming directories are set up correctly	10ヶ月前
build.sh	stamp the kernel variant onto the version string	10ヶ月前
docs-metadata.yml	added a title for PDF generation	4年前
finddesc.lua	Fix document generation on Windows (using Git Bash)	4年前
gendoc.lua	added doc() support for pre-compiled API documentation, wrote a generator for it, and included that in the build script	4年前
luapreproc.lua	added type annotations and descriptions for functions where appropriate	4年前
package.sh	added minitel to the default init, updated the package script	4年前
preproc.lua	update to match latest diskpart	10ヶ月前
template.tex	updated finddesc to use the new doc library, allowing type annotations and building a directory of documentation	4年前

README.md

OC-PsychOS2

A lightweight, multi-user operating system for OpenComputers

Building

The kernel

The kernel is composed of a number of modules, found in the module/ directory, as specified by a file in the kcfg directory, base by default. Which modules are included can be customised by changing the include statements in the kernel configuration file; copying it and customizing that is recommended, so you can git pull later without having to stash or reset your changes.

Unix-like systems

The kernel can be built using the preproc library and provided scripts:

lua build.lua kcfg/base.cfg kernel.lua

PsychOS

The kernel can be built from inside PsychOS using the preproc library, assuming you have the kernel source available:

preproc("kcfg/base.cfg","kernel.lua")

The boot filesystem

A boot filesystem contains several things:

The kernel, as init.lua
The lib/ directory, containing libraries
The service/ directory, containing system services
The exec/ directory, containing single-shot executable files

This has been automated in the form of build.sh, pending a real makefile.

Documentation

Documentation is generated as the system is built with build.sh; a set of markdown files will be placed into doc/, as well as an all-in-one apidoc.md. If pandoc is installed, an apidoc.pdf will also be generated.