27 lines
1.1 KiB
Zig
27 lines
1.1 KiB
Zig
//! The root module every user binary is compiled through (build.zig,
|
|
//! `addUserBinary`). The program's own file is imported as `program`, and this
|
|
//! shim contributes the declarations Zig resolves from the compilation root —
|
|
//! `main` (dispatched by start's comptime dispatch) and the panic handler — and
|
|
//! pulls in the `_start` entry shim. A program therefore only defines
|
|
//! `pub fn main`; nothing else is required in its source file.
|
|
|
|
const start = @import("start");
|
|
const logging = @import("logging");
|
|
const program = @import("program");
|
|
|
|
/// Resolved as `@import("root").main` by start's comptime dispatch.
|
|
pub const main = program.main;
|
|
|
|
/// The panic handler for every safety check in the image (start.panic).
|
|
pub const panic = start.panic;
|
|
|
|
/// std.log for every user binary goes to the tagged kernel log ring (the kernel
|
|
/// stamps the sender; see the logging module). A program overrides by declaring
|
|
/// its own `pub const std_options`.
|
|
pub const std_options: @import("std").Options =
|
|
if (@hasDecl(program, "std_options")) program.std_options else logging.default_options;
|
|
|
|
comptime {
|
|
_ = &start._start; // pull the entry shim into the image
|
|
}
|