Userland SDK Reference
-
Comprehensive manual for custom libc and system calls in BoredOS.
+
Overview and entry point for BoredOS userland development.
---
-BoredOS provides a custom `libc` implementation necessary for writing userland applications (`.elf` binaries). By avoiding a full-blown standard library like `glibc`, the OS ensures a minimal executable footprint tailored strictly to the existing kernel features.
+BoredOS provides a compact userland SDK for building `.elf` applications.
+This page is the high-level map; detailed API references now live in dedicated pages.
-All headers are located in `src/userland/libc/` (standard functions) and `src/wm/` (UI and widgets).
-- `stdlib.h`: Memory, strings, and basic I/O.
-- `math.h`: Freestanding floating-point math library.
-- `libui.h`: Core window and drawing API.
-- `libwidget.h`: High-level UI components.
+## SDK Structure
-## Standard Library (`stdlib.h` & `string.h`)
+Primary headers are in `src/userland/libc/` and UI helpers are in `src/wm/`.
-The standard library wrappers provide memory management, string manipulation, and basic IO formatting without needing direct syscalls.
+- `stdlib.h`, `string.h`, `stdio.h`, `unistd.h`: core libc surface
+- `syscall.h`: raw syscall wrappers and command constants
+- `libui.h`: window creation, drawing, and event polling
+- `libwidget.h`: higher-level reusable widgets
+- `math.h`: freestanding math helpers
-### Memory Allocation
-* `void* malloc(size_t size);` - Allocate a block of memory on the heap.
-* `void free(void* ptr);` - Free a previously allocated memory block.
-* `void* calloc(size_t nmemb, size_t size);` - Allocate and zero-out a block of memory for an array.
-* `void* realloc(void* ptr, size_t size);` - Resize an existing memory block.
+## Detailed References
-### Memory Manipulation (`string.h`)
-* `void* memset(void *s, int c, size_t n);` - Fill a block of memory with a specific byte.
-* `void* memcpy(void *dest, const void *src, size_t n);` - Copy memory from source to destination.
-* `void* memmove(void *dest, const void *src, size_t n);` - Safely copy overlapping memory blocks.
-* `int memcmp(const void *s1, const void *s2, size_t n);` - Compare two memory blocks.
+- [`libc Reference`](libc_reference.md): current libc headers and implemented APIs
+- [`Syscalls`](syscalls.md): syscall numbers, FS/SYSTEM command IDs, and wrappers
+- [`UI API`](ui_api.md): drawing and event APIs
+- [`Widget API`](widget_api.md): common widgets and interaction helpers
-### String Utilities
-* `size_t strlen(const char *s);` - Get the length of a string.
-* `int strcmp(const char *s1, const char *s2);` - Compare two strings lexicographically.
-* `char* strcpy(char *dest, const char *src);` - Copy a string to a destination buffer.
-* `char* strcat(char *dest, const char *src);` - Concatenate two strings.
-
-### Conversion and Formatting
-* `int atoi(const char *nptr);` - String to integer conversion.
-* `void itoa(int n, char *buf);` - Integer to string conversion.
-
-### Input / Output
-* `void puts(const char *s);` - Print a string followed by a newline to the standard output.
-* `void printf(const char *fmt, ...);` - Formatted print to standard output (supports `%d`, `%s`, `%x`, etc.).
-
-### Process Control
-* `void exit(int status);` - Terminate the current process.
-* `void sleep(int ms);` - Pause execution for a specified number of milliseconds.
-
----
-
-## Math Library (`math.h`)
-
-BoredOS ships a freestanding floating-point math library in `libc/math.h`. It uses pure arithmetic — Taylor series, Newton-Raphson, and range-reduction — with no dependency on a host `libm` or hardware math intrinsics. It is automatically linked into every userland ELF.
+## Typical Include Set
```c
-#include "math.h"
+#include