{"id":25649883,"url":"https://github.com/kolibrios/umka","last_synced_at":"2025-06-24T19:41:40.040Z","repository":{"id":41115519,"uuid":"434190964","full_name":"KolibriOS/umka","owner":"KolibriOS","description":"User-Mode KolibriOS developer tools","archived":false,"fork":false,"pushed_at":"2025-01-22T15:08:02.000Z","size":44550,"stargazers_count":22,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-13T10:04:40.327Z","etag":null,"topics":["anykernel","c11","fasm","kolibrios","qcow2","testing-tools","unittest","virtual"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KolibriOS.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-12-02T11:19:44.000Z","updated_at":"2025-01-22T15:08:07.000Z","dependencies_parsed_at":"2025-02-23T14:46:55.493Z","dependency_job_id":null,"html_url":"https://github.com/KolibriOS/umka","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KolibriOS/umka","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KolibriOS%2Fumka","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KolibriOS%2Fumka/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KolibriOS%2Fumka/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KolibriOS%2Fumka/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KolibriOS","download_url":"https://codeload.github.com/KolibriOS/umka/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KolibriOS%2Fumka/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259624723,"owners_count":22886328,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anykernel","c11","fasm","kolibrios","qcow2","testing-tools","unittest","virtual"],"created_at":"2025-02-23T14:35:14.139Z","updated_at":"2025-06-13T10:08:56.218Z","avatar_url":"https://github.com/KolibriOS.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"UMKa -- User-Mode KolibriOS developer tools\n===========================================\n\nThis is a common project for a set of KolibriOS developer tools which are based\non original KolibriOS kernel code wrapped and hacked as to run in the UNIX\nprogramming environment. The idea is to make userspace UNIX tools that use as\nmuch unchanged KolibriOS kernel source as possible to run, test and debug\narchitecture-independent parts of the kernel in your favorite developer\nenvironment.\n\nWhat works now:\n * block layer (disk, cache, partition, MBR, GPT),\n * file systems except iso9660 (fat*, exfat, ext*, xfs),\n * UI and graphics (geometric primitives, windows, winmap, cursors),\n * basic network (configuration, ping replies),\n * interrupts (via signals),\n * threads and processes,\n * scheduler,\n * slab allocator,\n * events,\n * synchronization primitives,\n * unpacker,\n * string functions,\n * other minor functions.\n\n\numka_shell\n----------\n\nis an interactive shell with commands that are wrappers around KolibriOS kernel\nsyscalls and other internal functions. It can also be used for automated testing\nby feeding it a file of commands instead of typing them.\n\nExample:\n    $ umka_shell \u003c mytest.t\n\n\numka_fuse\n---------\n\nis like umka_shell above but commands are translated from FUSE calls, not\nentered manually or read from a file. Can *potentially* be used to run xfstests\n(cross-fs-tests) and automated tests against reference FS implementation.\n\n\numka_os\n-------\n\nis KolibriOS kernel running main loop (osloop), scheduler and all the threads\nincluding network stack.\n\n\ntools\n-----\n\nmkdirrange - make directories with names in range\n\nmkfilepattern - make a file with contents of specific pattern\n\n\nBUILD\n-----\n\nLinux:\n\n$ KOLIBRIOS=/path/to/kolibrios HOST=linux CC=gcc make\n\n/path/to/kolibrios is where you checked out 'svn co svn://kolibrios.org'.\n\nWindows:\n\nSame but specify HOST=windows and your favourite C compiler.\n\n\nArchitecture\n------------\n\nKernel services are replaced with stubs, wrappers around userspace\nimplementation or libc calls. Block devices are emulated with regular files.\nFramebuffer can be dumped to disk as image file.\n\n\nTesting\n-------\n\n# Run all the tests\n\n    $ HOST=linux make -B\n\n# Copy ACPI tables and PCI configs\n\n    # cp --parents /sys/firmware/acpi/tables/?SDT* /sys/bus/pci/devices/*/config .\n\n# Manage tap device\n\n    # ip tuntap add dev tap0 mode tap\n    # ip link set tap0 address 00:11:00:00:00:00\n    # ip addr add 10.50.0.1/24 dev tap0\n    # ip link set up dev tap0\n    # ip tuntap del dev tap0 mode tap\n\n\nTroubleshooting\n---------------\n\n# Build\n\n    Install toolchain for the 32-bit target, e.g. gcc-multilib, lib32-glibc,\n    32-bit and develop packages of libfuse and libsdl2, fasm.\n\n# umka_os\n\nTo create tap devices.\n\n    # setcap cap_net_admin+ep umka_os\n\nTo load apps at 0 address.\n\n    # sysctl -w vm.mmap_min_addr=0\n\nAllow reading process_vm_readv syscall.\n\n    # sysctl -w kernel.yama.ptrace_scope=0\n\nInsert msr linux kernel module to collect coverage.\n\n    # modprobe msr\n\n\nLinks \u0026 Acknowledgements\n------------------------\n\n[1] Filesystem in Userspace\n    https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/fs/fuse\n\n[2] Filesystem in Userspace library\n    https://github.com/libfuse/libfuse\n\n[3] LodePNG by Lode Vandevenne\n    https://lodev.org/lodepng/\n\n[4] Optparse by Christopher Wellons\n    https://github.com/skeeto/optparse\n\n[5] Universal TUN/TAP device driver by Maxim Krasnyansky and others\n    https://www.kernel.org/doc/html/v5.12/networking/tuntap.html\n\n[6] Isocline by Daan Leijen\n    https://github.com/daanx/isocline\n\n[7] em_inflate by Emmanuel Marty\n    https://github.com/emmanuel-marty/em_inflate\n\n[8] qemu-nbd by Anthony Liguori and others\n    https://www.qemu.org/docs/master/tools/qemu-nbd.html\n\n[9] Simple DirectMedia Layer library aka SDL2\n    https://libsdl.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkolibrios%2Fumka","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkolibrios%2Fumka","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkolibrios%2Fumka/lists"}