nx_shell_lib.nx

buildroot/runtime/nx_shell_lib.nx

9011 B166 linesdepth 3pulls 4 transitivereach 2 importersview sourcekind librarytopic shell

docs dependencies structs consts functions

about

nx_shell_lib.nx -- GENERAL SOVEREIGN SHELL CAPABILITY (the shared library for the Nishi shell toolchain). Extracted (rule 15) so the gate (nx_shell) and the drivable tool (nx_shell_run) share ONE capability, not copies. Pure library: no main. Imports only nx_syscalls (the kernel last-mile). NEVER-BRICK: spawns userspace, writes 0 persistent hardware state -> brick-safe by construction (cardinal 26). UI g_puts/g_pn STR sh_slen/sh_streq R1 sh_tokenize (command line -> argv) R3 sh_builtin (echo/cd/true/false in-process) R4 sh_grep (substring) / sh_grep_stream (pipeline filter: fd0->fd1) / sh_run_capture (pipe-capture) R2 sh_run (fork+execve+wait) / sh_exec_one (builtin-or-exec one command) R5 sh_split_ops / sh_exec_line (; && ||) R6/full sh_split_pipe / sh_stage_exec / sh_run_pipeline (N-stage |) / sh_exec_full (pipelines + control)

dependencies 3 imports · 2 importers

imports: nx_syscalls.nxnx_itoa_lib.nxnx_regex_lib.nx

imported by: nx_shell.nxnx_shell_run.nx

structs

none

consts

16	const K_MAGIC_65536: i64 = 65536

functions

18	func g_puts(s: *u8) -> i64 { var n: i64=0; while s[n]!=(0 as u8){n=n+1} sys_write(1,s,n); return 0 } called by 5: ck main sh_builtin run_line main calls 1: sys_write
23	func g_pn(v: i64) -> i64 { nxi_out(v); return 0 } called by 2: main main calls 1: nxi_out
24	func sh_slen(s: *u8) -> i64 { var n: i64=0; while s[n]!=(0 as u8){n=n+1} return n } called by 1: sh_grep
25	func sh_streq(a: u8, b: u8) -> i64 { var i: i64=0; while a[i]!=(0 as u8) { if a[i]!=b[i] { return 0 } i=i+1 } if b[i]==(0 as u8) { return 1 } return 0 } called by 2: sh_builtin sh_stage_exec
27	func sh_tokenize(line: u8, copy: u8, argv: *i64, maxtok: i64) -> i64 called by 3: main sh_exec_one sh_stage_exec
38	func sh_builtin(argv: *i64, argc: i64) -> i64 called by 3: main sh_exec_one sh_stage_exec calls 3: sh_streq sys_chdir g_puts
48	func sh_grep(buf: u8, n: i64, needle: u8) -> i64 { if sh_slen(needle)==0 { return 0 } return re_search(needle, buf, n) } called by 2: main sh_grep_stream calls 2: sh_slen re_search
49	func sh_grep_stream(pattern: *u8) -> i64 called by 2: main sh_stage_exec calls 4: sys_mmap sys_read sh_grep sys_write
61	func sh_run(path: u8, argv: i64) -> i64 called by 2: main sh_exec_one calls 6: sys_fork sys_execve sys_exit sys_mmap sys_wait4 wait_exit_code
66	func sh_run_capture(path: u8, argv: i64, out: *u8, cap: i64) -> i64 calls 9: sys_mmap sys_pipe2 sys_fork sys_dup3 sys_close sys_execve+3
77	func sh_exec_one(cmdline: *u8) -> i64 called by 2: sh_exec_line sh_run_pipeline calls 4: sys_mmap sh_tokenize sh_builtin sh_run
86	func sh_split_ops(line: u8, copy: u8, segp: i64, sego: i64, maxseg: i64) -> i64 called by 2: sh_exec_line sh_exec_full
98	func sh_exec_line(line: *u8) -> i64 called by 1: main calls 3: sys_mmap sh_split_ops sh_exec_one
113	func sh_split_pipe(line: u8, copy: u8, stages: *i64, maxst: i64) -> i64 called by 1: sh_run_pipeline
120	func sh_stage_exec(stage_line: *u8) -> i64 called by 1: sh_run_pipeline calls 7: sys_mmap sh_tokenize sys_exit sh_streq sh_grep_stream sh_builtin+1
129	func sh_run_pipeline(segment: *u8) -> i64 called by 1: sh_exec_full calls 11: sys_mmap sh_split_pipe sh_exec_one sys_pipe2 sys_fork sys_dup3+5
154	func sh_exec_full(line: *u8) -> i64 called by 1: run_line calls 3: sys_mmap sh_split_ops sh_run_pipeline