code wiki / (root) / nx_file_install.nx

nx_file_install.nx

buildroot/runtime/nx_file_install.nx

21537 B413 linesdepth 6pulls 6 transitivereach 42 importersview sourcekind librarytopic file

docs dependencies structs consts functions

about

Recoverable file installation. An immutable, checksummed intent identifies every pathname and both artifact digests. No process-local pointer is persisted. Runtime/service health is a later acceptance step, not implied by file install.

dependencies 1 imports · 9 importers

imports: nx_fio.nx

imported by: nx_fileop.nxnx_fileop_intent_20260910.nxnx_fio_region_gate.nxnx_hostctl.nxnx_mgmt_cap_data_candidate_t186.nxnx_mgmt_data.nxnx_mgmt_data.pre-toolchain-20260910.nxnx_mgmt_deploy_data_candidate_t185.nxnx_rollback_executor_t185.nx

structs

16	struct NxFileInstallPlan
27	struct NxFileInstallResult
314	struct NxFileInstallSession

consts

7	const FI_MAGIC: *u8="NXFINST1"
8	const FI_MAGIC_BYTES: i64=8
9	const FI_DIGEST_BYTES: i64=32
10	const FI_WORD_BYTES: i64=8
11	const FI_PATH_FIELDS: i64=4
12	const FI_HEADER_BYTES: i64=FI_MAGIC_BYTES + FI_DIGEST_BYTES2 + FI_WORD_BYTES(1+FI_PATH_FIELDS)
13	const FI_ENOENT: i64=0-2
14	const FI_EACCES: i64=0-13 // Linux errno: recorded target is outside the supplied authorization.

functions

34	func fi_len(s: *u8) -> i64 called by 18: fi_paths_distinct fi_plan_create fi_install_core fi_session_bind fi_session_prepare_reverse fo_digest+12
38	func fi_same(a: u8,b: u8,n: i64) -> i64 called by 13: fi_paths_distinct fi_plan_decode fi_install_core fi_session_bind fi_session_reverse fi_session_prepare_reverse+7
43	func fi_copy(dst: u8,src: u8,n: i64) -> i64 called by 10: fi_plan_create frg_absolute frg_install_http_request frg_install_http_checks frg_registered_checks frg_target_checks+4
48	func fi_path_valid(path: *u8) -> i64 called by 22: fi_paths_distinct fi_install_bound fi_session_bind fi_session_begin fi_session_reverse fi_session_prepare_reverse+16
65	func fi_paths_distinct(names: *i64) -> i64 called by 2: fi_plan_decode fi_plan_create calls 3: fi_path_valid fi_len fi_same
80	func fi_word_put(p: *u8,v: i64) -> i64 called by 1: fi_plan_create
83	func fi_word_get(p: *u8) -> i64 called by 1: fi_plan_decode
87	func fi_plan_init(p: *NxFileInstallPlan) -> i64 called by 10: fi_plan_close fi_plan_read fi_install_core fi_session_init fi_session_reverse fi_session_prepare_reverse+4
91	func fi_plan_close(p: *NxFileInstallPlan) -> i64 called by 8: fi_install_core fi_session_close fi_session_reverse fi_session_prepare_reverse fo_prepare_intent fo_prepare_intent+2 calls 1: fi_plan_init
98	func fi_plan_decode(bytes: u8,n: i64,p: NxFileInstallPlan) -> i64 called by 1: fi_plan_read calls 3: fi_same fi_word_get fi_paths_distinct
137	func fi_plan_read(path: u8,budget: i64,p: NxFileInstallPlan) -> i64 called by 8: fi_install_core fi_session_begin fi_session_reverse fi_session_prepare_reverse fo_prepare_intent fo_prepare_intent+2 calls 6: fi_plan_init fio_region_init fio_region_open fio_region_next fio_region_close fi_plan_decode
158	func fi_plan_create(path: u8,source: u8,live: u8,candidate: u8,backup: u8,mode: i64,new_digest: u8,old_digest: u8,budget: i64,out: NxFileWriteResult) -> i64 called by 3: fo_prepare_intent fo_prepare_intent frg_install_checks calls 6: fi_paths_distinct fi_len fi_copy fi_word_put fio_write_sync_fd fio_sync_parent
200	func fi_sync_existing(path: u8,out: NxFileWriteResult) -> i64 called by 6: fi_prepare_expected fi_install_owned fi_install_core fi_session_begin fi_session_reverse fi_session_prepare_reverse calls 1: fio_write_sync_fd
208	func fi_prepare_expected(source: u8,path: u8,digest: u8,mode: i64,buffer: u8,capacity: i64,out: *NxFilePrepareResult) -> i64 called by 2: fi_install_owned fi_session_prepare_reverse calls 3: fio_verify_sha256 fio_prepare_copy fi_sync_existing
225	func fi_install_owned(p: NxFileInstallPlan,buffer: u8,capacity: i64,out: *NxFileInstallResult) -> i64 called by 3: fi_install_core fi_session_publish fi_session_reverse calls 5: fio_verify_sha256 fi_sync_existing fio_sync_parent fi_prepare_expected fio_publish_candidate
258	func fi_install_core(plan_path: u8,record_budget: i64,buffer: u8,capacity: i64,allowed_live: u8,expected_intent: u8,out: *NxFileInstallResult) -> i64 called by 2: fi_install fi_install_bound calls 11: fio_replace_init fi_plan_init fi_plan_read fi_same fi_len fio_target_lock_acquire+5
298	func fi_install(plan_path: u8,record_budget: i64,buffer: u8,capacity: i64,out: *NxFileInstallResult) -> i64 called by 1: frg_install_checks calls 1: fi_install_core
301	func fi_install_bound(plan_path: u8,record_budget: i64,buffer: u8,capacity: i64,allowed_live: u8,expected_intent: u8,out: *NxFileInstallResult) -> i64 called by 5: frg_install_checks md_install_registered md_install_registered md_install_registered md_install_registered calls 3: fi_path_valid fio_replace_init fi_install_core
321	func fi_session_init(s:*NxFileInstallSession)->i64 called by 3: md_tc_session_init md_tc_session_init md_tc_session_init calls 2: fi_plan_init fio_target_lock_init
325	func fi_session_bind(p:NxFileInstallPlan,allowed_live:u8,expected_intent:*u8)->i64 called by 3: fi_session_begin fi_session_reverse fi_session_prepare_reverse calls 3: fi_path_valid fi_same fi_len
336	func fi_session_close(s:*NxFileInstallSession)->i64 called by 3: md_tc_session_close md_tc_session_close md_tc_session_close calls 2: fio_target_lock_release fi_plan_close
345	func fi_session_begin(path:u8,budget:i64,allowed_live:u8,expected_intent:u8,s:NxFileInstallSession)->i64 called by 3: md_tc_session_run md_tc_session_run md_tc_session_run calls 6: fi_path_valid fi_plan_read fi_session_bind fio_target_lock_acquire fi_sync_existing fio_sync_parent
361	func fi_session_result_init(out:*NxFileInstallResult)->i64 called by 6: fi_session_publish fi_session_reverse fi_session_prepare_reverse md_tc_session_init md_tc_session_init md_tc_session_init calls 1: fio_replace_init
366	func fi_session_publish(s:NxFileInstallSession,buffer:u8,capacity:i64,out:*NxFileInstallResult)->i64 called by 3: md_tc_session_run md_tc_session_run md_tc_session_run calls 2: fi_session_result_init fi_install_owned
373	func fi_session_reverse(s:NxFileInstallSession,path:u8,budget:i64,expected_intent:u8,buffer:u8,capacity:i64,out:*NxFileInstallResult)->i64 called by 3: md_tc_session_run md_tc_session_run md_tc_session_run calls 10: fi_session_result_init fi_path_valid fi_plan_init fi_plan_read fi_session_bind fi_same+4
392	func fi_session_prepare_reverse(s:NxFileInstallSession,path:u8,budget:i64,expected_intent:u8,buffer:u8,capacity:i64,out:*NxFileInstallResult)->i64 called by 3: md_tc_session_run md_tc_session_run md_tc_session_run calls 11: fi_session_result_init fi_path_valid fi_plan_init fi_plan_read fi_session_bind fi_same+5