izaya
/
OC-PsychOS2
mirror of https://git.shadowkat.net/izaya/OC-PsychOS2.git
1
1
Fork 0
Code Issues 0 Releases 0 Wiki Activity
Operating system for OpenComputers
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
305 Commits
1 Branch
648KB
Branch: master
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'master'
${ noResults }
XeonSquared 1c647c76fe fix timeout accounting in the scheduler 10 months ago
kcfg refactor build system to allow pulling libraries from packages, assuming directories are set up correctly 1 year ago
lib cleanup RPC library, make it possible to detect the client hostname when running RPC requests 10 months ago
module fix timeout accounting in the scheduler 10 months ago
service skip mounting any already mounted filesystems 11 months ago
.editorconfig clipboard: Make the clipboard service work under the new service sys 4 years ago
.gitignore clipboard: Make the clipboard service work under the new service sys 4 years ago
INSTALL.md early work on OpenOS bootstrapping 11 months ago
LICENSE Initial commit 6 years ago
README.md update to match latest diskpart 1 year ago
build.lua add some simple minification filters to preproc, which can shrink the kernel significantly 1 year ago
build.sh stamp the kernel variant onto the version string 1 year ago
docs-metadata.yml added a title for PDF generation 4 years ago
finddesc.lua Fix document generation on Windows (using Git Bash) 4 years ago
gendoc.lua added doc() support for pre-compiled API documentation, wrote a generator for it, and included that in the build script 4 years ago
luapreproc.lua added type annotations and descriptions for functions where appropriate 4 years ago
obootstrap.lua early work on OpenOS bootstrapping 11 months ago
package.sh added minitel to the default init, updated the package script 4 years ago
preproc.lua add some simple minification filters to preproc, which can shrink the kernel significantly 1 year ago
template.tex updated finddesc to use the new doc library, allowing type annotations and building a directory of documentation 4 years ago

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.