code wiki / _hdl_build / nx_file_install_session_20260910.nx

nx_file_install_session_20260910.nx

buildroot/runtime/_hdl_build/nx_file_install_session_20260910.nx

21537 B413 linesdepth 6pulls 6 transitivereach 3 importersview sourcekind librarytopic file
docsdependenciesstructsconstsfunctions

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 · 1 importers

nx_fio.nx nx_file_install_session_202609 nx_mgmt_data_toolchain_session_202

imports: nx_fio.nx

imported by: nx_mgmt_data_toolchain_session_20260910.nx

structs

16struct NxFileInstallPlan
27struct NxFileInstallResult
314struct NxFileInstallSession

consts

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

functions

34func fi_len(s: *u8) -> i64
called by 6: fi_paths_distinctfi_plan_createfi_install_corefi_session_bindfi_session_prepare_reversemd_tc_session_run
38func fi_same(a: *u8,b: *u8,n: i64) -> i64
called by 6: fi_paths_distinctfi_plan_decodefi_install_corefi_session_bindfi_session_reversefi_session_prepare_reverse
43func fi_copy(dst: *u8,src: *u8,n: i64) -> i64
called by 2: fi_plan_createmd_target_decode
48func fi_path_valid(path: *u8) -> i64
called by 9: fi_paths_distinctfi_install_boundfi_session_bindfi_session_beginfi_session_reversefi_session_prepare_reverse+3
65func fi_paths_distinct(names: *i64) -> i64
called by 2: fi_plan_decodefi_plan_create calls 3: fi_path_validfi_lenfi_same
80func fi_word_put(p: *u8,v: i64) -> i64
called by 1: fi_plan_create
83func fi_word_get(p: *u8) -> i64
called by 1: fi_plan_decode
87func fi_plan_init(p: *NxFileInstallPlan) -> i64
called by 6: fi_plan_closefi_plan_readfi_install_corefi_session_initfi_session_reversefi_session_prepare_reverse
91func fi_plan_close(p: *NxFileInstallPlan) -> i64
called by 4: fi_install_corefi_session_closefi_session_reversefi_session_prepare_reverse calls 1: fi_plan_init
98func fi_plan_decode(bytes: *u8,n: i64,p: *NxFileInstallPlan) -> i64
called by 1: fi_plan_read calls 3: fi_samefi_word_getfi_paths_distinct
137func fi_plan_read(path: *u8,budget: i64,p: *NxFileInstallPlan) -> i64
called by 4: fi_install_corefi_session_beginfi_session_reversefi_session_prepare_reverse calls 6: fi_plan_initfio_region_initfio_region_openfio_region_nextfio_region_closefi_plan_decode
158func 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
calls 6: fi_paths_distinctfi_lenfi_copyfi_word_putfio_write_sync_fdfio_sync_parent
200func fi_sync_existing(path: *u8,out: *NxFileWriteResult) -> i64
called by 6: fi_prepare_expectedfi_install_ownedfi_install_corefi_session_beginfi_session_reversefi_session_prepare_reverse calls 1: fio_write_sync_fd
208func fi_prepare_expected(source: *u8,path: *u8,digest: *u8,mode: i64,buffer: *u8,capacity: i64,out: *NxFilePrepareResult) -> i64
called by 2: fi_install_ownedfi_session_prepare_reverse calls 3: fio_verify_sha256fio_prepare_copyfi_sync_existing
225func fi_install_owned(p: *NxFileInstallPlan,buffer: *u8,capacity: i64,out: *NxFileInstallResult) -> i64
called by 3: fi_install_corefi_session_publishfi_session_reverse calls 5: fio_verify_sha256fi_sync_existingfio_sync_parentfi_prepare_expectedfio_publish_candidate
258func 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_installfi_install_bound calls 11: fio_replace_initfi_plan_initfi_plan_readfi_samefi_lenfio_target_lock_acquire+5
298func fi_install(plan_path: *u8,record_budget: i64,buffer: *u8,capacity: i64,out: *NxFileInstallResult) -> i64
calls 1: fi_install_core
301func fi_install_bound(plan_path: *u8,record_budget: i64,buffer: *u8,capacity: i64,allowed_live: *u8,expected_intent: *u8,out: *NxFileInstallResult) -> i64
called by 1: md_install_registered calls 3: fi_path_validfio_replace_initfi_install_core
321func fi_session_init(s:*NxFileInstallSession)->i64
called by 1: md_tc_session_init calls 2: fi_plan_initfio_target_lock_init
325func fi_session_bind(p:*NxFileInstallPlan,allowed_live:*u8,expected_intent:*u8)->i64
called by 3: fi_session_beginfi_session_reversefi_session_prepare_reverse calls 3: fi_path_validfi_samefi_len
336func fi_session_close(s:*NxFileInstallSession)->i64
called by 1: md_tc_session_close calls 2: fio_target_lock_releasefi_plan_close
345func fi_session_begin(path:*u8,budget:i64,allowed_live:*u8,expected_intent:*u8,s:*NxFileInstallSession)->i64
called by 1: md_tc_session_run calls 6: fi_path_validfi_plan_readfi_session_bindfio_target_lock_acquirefi_sync_existingfio_sync_parent
361func fi_session_result_init(out:*NxFileInstallResult)->i64
called by 4: fi_session_publishfi_session_reversefi_session_prepare_reversemd_tc_session_init calls 1: fio_replace_init
366func fi_session_publish(s:*NxFileInstallSession,buffer:*u8,capacity:i64,out:*NxFileInstallResult)->i64
called by 1: md_tc_session_run calls 2: fi_session_result_initfi_install_owned
373func fi_session_reverse(s:*NxFileInstallSession,path:*u8,budget:i64,expected_intent:*u8,buffer:*u8,capacity:i64,out:*NxFileInstallResult)->i64
called by 1: md_tc_session_run calls 10: fi_session_result_initfi_path_validfi_plan_initfi_plan_readfi_session_bindfi_same+4
392func fi_session_prepare_reverse(s:*NxFileInstallSession,path:*u8,budget:i64,expected_intent:*u8,buffer:*u8,capacity:i64,out:*NxFileInstallResult)->i64
called by 1: md_tc_session_run calls 11: fi_session_result_initfi_path_validfi_plan_initfi_plan_readfi_session_bindfi_same+5