1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
hilbert os is a 64-bit hobby operating system, which is not very mature yet. to
build and test it, you will need some software installed. on debian, i believe
the packages listed below are sufficient.
- bison
- flex
- g++
- gdb
- git
- libgmp-dev
- libmpfr-dev
- libmpc-dev
- make
- nasm
- qemu-system-x86
- texinfo
- xorriso
next, you will need to download and compile some dependencies. the script in
setup.sh will do this for you. if it sees an environment variables MAKEOPTS, it
will pass the contents of that as arguments to invocations of make. otherwise,
it defaults to "-j$(nproc)".
now that we have all the dependencies, just run "make". the default target is
build/disk.iso, a bios-bootable disk image. you can run "make debug" to start
qemu with that disk, and attach gdb to it. you will have to run "continue" (or
"c" for short) in gdb to let qemu start. consider temporarily changing -O3 to
-Og in the CC_EXTRA_ARGS variable of the makefile temporarily if you want to
do any serious debugging.
acknowledgements (any under "dependencies" are downloaded during build):
- dependencies/binutils (gnu binutils v2.42)
copyright 2024 free software foundation, inc.
license: dependencies/binutils/COPYING (gnu gpl v2)
homepage: https://www.gnu.org/software/binutils/
- dependencies/gcc (gnu compiler collection v14.1.0)
copyright 2024 free software foundation, inc.
license:
dependencies/gcc/COPYING3 (gnu gpl v3)
dependencies/gcc/COPYING.RUNTIME (gcc runtime library exception v3.1)
homepage: https://gcc.gnu.org/
i patch the output <memory> header file from libstdc++ with
patches/gcc-memory.patch to include my std::allocator implementation.
- dependencies/limine (limine bootloader v7.5.1)
copyright 2019 - 2024 mintsuki and contributors
license: dependencies/limine/COPYING (bsd two-clause)
homepage: https://limine-bootloader.org/
- dependencies/minstuki-headers
copyright 2022 - 2024 mintsuki and contributors
license: dependencies/mintsuki-headers/LICENSE (bsd zero-clause)
homepage: https://github.com/osdev0/freestanding-headers/
i patch the <stddef.h> header file with patches/minstuki-stddef.patch
to add a max_align_t type to make libstdc++ happy. i use the commit
dd3abd2d7147efc4170dff478d3b7730bed14147 so i don't have to worry
about that file changing in a future commit.
- skeleton/assets/burden.ppm
("selective focus photography snowflakes" by aaron burden)
license: https://unsplash.com/license
source: https://unsplash.com/photos/selective-focus-photography-snowflakes-9yhy1FXlKwI
- skeleton/assets/terminus/*.psf (terminus font)
copyright 2020 dimitar toshkov zhekov
license: skeleton/assets/terminus-ofl.txt (sil open font license v1.1)
homepage: https://terminus-font.sourceforge.net/
the following directories and files are copyright 2024 benji dial, under the
license in isc.txt (isc license):
- applications
- euler
- kernel
- libraries
- makefile
the following file are released under the text in 0bsd.txt (zero-clause bsd):
- clean-setup.sh
- makefile
- setup.sh
the following directories and files are released under the text in cc0.txt
(creative commons cc0 1.0 universal public domain dedication):
- documentation
- skeleton/assets/pointer.ppm
project structure:
- applications/clock:
a simple application that displays the current time in EDT.
- applications/goldman:
the default compositor.
- applications/init:
the initial program loaded by the kernel. currently it just starts the
compositor and the clock, but in the future it will read some kind of
configuration file and decide what to do based on that.
- documentation:
documentation. currently this directory is a bit disorganized, and has
some descriptions of things that have not been created yet.
- euler:
(a minimal start to) a c++20 standard library, plus some hilbert
specific functions. this uses the freestanding part of libstdc++.
- kernel:
the kernel.
- libraries/daguerre:
an image loading / rendering library.
- libraries/pake:
a widget library for windowed applications
- patches:
a couple patches that are applied to dependencies
- skeleton:
files that are copied directly to the initfs.
|