Go to file
2020-10-14 06:30:01 +03:00
img Improve branch coverage for error-free cases. 2020-03-12 00:51:48 +03:00
linux Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00
test Add two new test acpi+pci configurations. 2020-10-09 00:19:53 +03:00
tools New tool lfbviewx, new shell commands, fix bug in process_info(-1). 2020-10-12 06:02:02 +03:00
.gitignore New tool lfbviewx, new shell commands, fix bug in process_info(-1). 2020-10-12 06:02:02 +03:00
covpreproc.c Introduce COVERAGE_ON/OFF macros, rename shell functions to shell_*. 2020-03-10 00:03:57 +03:00
GPL2.txt Collect coverage via LBR profiling. 2019-10-09 02:35:47 +03:00
GPL3.txt Collect coverage via LBR profiling. 2019-10-09 02:35:47 +03:00
indent_begin_end.py Add script indent_begin_end.py to make logs more readable. 2020-05-19 14:21:47 +03:00
LICENSE Collect coverage via LBR profiling. 2019-10-09 02:35:47 +03:00
lodepng.c Update LodePNG, add -Wswitch-enum option. 2020-02-20 00:59:16 +03:00
lodepng.h Update LodePNG, add -Wswitch-enum option. 2020-02-20 00:59:16 +03:00
makefile Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00
README New tool lfbviewx, new shell commands, fix bug in process_info(-1). 2020-10-12 06:02:02 +03:00
shell.c Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00
shell.h Move shell from umka_shell to separate module. 2020-05-10 07:21:49 +03:00
system.inc Run net stack, jump to the osloop. Compiles, doesn't crash. 2020-05-09 05:15:57 +03:00
TODO Fix reading at the end of file, update tests, add TODO. 2019-10-27 03:54:38 +03:00
trace_lbr.c Use -Wpedantic and flexible array members instead of zero-length arrays. 2020-09-17 19:44:57 +03:00
trace_lbr.h Introduce COVERAGE_ON/OFF macros, rename shell functions to shell_*. 2020-03-10 00:03:57 +03:00
trace.c New tests and images for coverage. Don't use sudo for mkfs. 2020-03-11 06:02:33 +03:00
trace.h New tests and images for coverage. Don't use sudo for mkfs. 2020-03-11 06:02:33 +03:00
umka_fuse.c Add background related functions; umka_os works. 2020-05-11 06:38:44 +03:00
umka_os.c Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00
umka_ping.c Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00
umka_shell.c Add background related functions; umka_os works. 2020-05-11 06:38:44 +03:00
umka.asm Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00
umka.h Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00
vdisk.c Merge kolibri.h and syscalls.h, rename kolibri.h to umka.h. 2020-05-07 04:57:01 +03:00
vdisk.h Merge kolibri.h and syscalls.h, rename kolibri.h to umka.h. 2020-05-07 04:57:01 +03:00
vnet.c Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00
vnet.h Many fixes to scheduler and especially network. Ping via tap0 works!! 2020-10-14 06:30:01 +03:00

UMKa -- User-Mode KolibriOS developer tools
===========================================

This is a common project for a set of KolibriOS developer tools which are based
on original KolibriOS kernel code wrapped and hacked as to run in the UNIX
programming environment. The idea is to make userspace UNIX tools that use as
much unchanged KolibriOS kernel source as possible to test
architecture-independent parts of the kernel in your favorite developer
environment.


umka_shell
----------

is an interactive shell with commands that are wrappers around KolibriOS kernel
syscalls and other internal functions. What works now: block layer including
disk cache, FS, UI and graphics, scheduler, ACPI/AML interpreter,
synchronization primitives, strings, slab allocator, events, unpacker, other
minor functions.

It can also be used for automated testing by feeding it a file of commands
instead of typing them.

Example:
    $ umka_shell < mytest.t > mytest.out.log


umka_fuse
---------

is like umka_shell above but commands are translated from FUSE calls, not
entered manually or read from a file. Can *potentially* be used to run xfstests
(cross-fs-tests) and automated tests against reference FS implementation.


umka_os
-------

is KolibriOS kernel running main loop (osloop), scheduler and all the threads
including network stack.


tools
-----

mkdirrange

mkfilepattern

lfbviewx


BUILD
-----

$ KOLIBRI=/path/to/kolibrios make

/path/to/kolibrios is where you checked out `svn co svn://kolibrios.org`.


Architecture
------------

Kernel services are replaced with stubs, wrappers around userspace
implementation or libc calls. Block devices are emulated with regular files.
Framebuffer can be dumped to disk as image file.


Testing
-------

sudo cp --parents /sys/firmware/acpi/tables/?SDT* /sys/bus/pci/devices/*/config .


Troubleshooting
---------------

# sysctl -w kernel.yama.ptrace_scope=0
# sysctl -w vm.mmap_min_addr=0


Links & Acknowledgements
------------------------

[1] Filesystem in Userspace library
    https://github.com/libfuse/libfuse

[2] LodePNG by Lode Vandevenne
    https://lodev.org/lodepng/