• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
  • Software-verification
    • Kestrel-books
    • X86isa
      • Program-execution
        • Dynamic-instrumentation
        • Initialize-x86-state
        • Binary-file-load-fn
        • Read-channel-into-byte-list1
        • Setting-up-page-tables
        • Init-zero-page
        • Load-file-into-memory
        • Linux-load
        • Init-sys-view
        • Load-elf-sections
        • Chars-to-c-str
        • String-to-c-str
        • Pack-u64
        • Pack-u32
        • Concrete-simulation-examples
        • Gdt-entry
      • Sdm-instruction-set-summary
      • Tlb
      • Booting-linux
      • Introduction
      • Asmtest
      • X86isa-build-instructions
      • Publications
      • Contributors
      • Machine
      • Implemented-opcodes
      • To-do
      • Proof-utilities
      • Peripherals
      • Model-validation
      • Modelcalls
      • Concrete-simulation-examples
      • Utils
      • Debugging-code-proofs
    • Axe
    • Execloader
  • Math
  • Testing-utilities

• Program-execution

Load-file-into-memory

Signature

(load-file-into-memory filename ptr x86 state) 
  → 
(mv file-contents x86 state)

Arguments

filename — Guard (stringp filename).

ptr — Guard (canonical-address-p ptr).

Returns

file-contents — Type (byte-listp file-contents), given (and (stringp filename) (canonical-address-p ptr) (state-p1 state)).

x86 — Type (x86p x86), given (x86p x86).

state — Type (state-p1 state), given (and (stringp filename) (state-p1 state)).

Definitions and Theorems

Function: load-file-into-memory

(defun load-file-into-memory (filename ptr x86 state)
  (declare (xargs :stobjs (x86 state)))
  (declare (xargs :guard (and (stringp filename)
                              (canonical-address-p ptr))))
  (let ((__function__ 'load-file-into-memory))
    (declare (ignorable __function__))
    (b* (((mv channel state)
          (open-input-channel filename
                              :byte state))
         ((when (not channel))
          (mv nil x86 state))
         ((mv file-contents state)
          (read-channel-into-byte-list channel (1- (ash 1 60))
                                       state))
         ((unless (canonical-address-p (+ ptr (len file-contents))))
          (mv nil x86 state))
         ((mv & x86)
          (write-bytes-to-memory ptr file-contents x86))
         (state (close-input-channel channel state)))
      (mv file-contents x86 state))))

Theorem: byte-listp-of-load-file-into-memory.file-contents

(defthm byte-listp-of-load-file-into-memory.file-contents
  (implies (and (stringp filename)
                (canonical-address-p ptr)
                (state-p1 state))
           (b* (((mv ?file-contents ?x86 acl2::?state)
                 (load-file-into-memory filename ptr x86 state)))
             (byte-listp file-contents)))
  :rule-classes :rewrite)

Theorem: x86p-of-load-file-into-memory.x86

(defthm x86p-of-load-file-into-memory.x86
  (implies (x86p x86)
           (b* (((mv ?file-contents ?x86 acl2::?state)
                 (load-file-into-memory filename ptr x86 state)))
             (x86p x86)))
  :rule-classes :rewrite)

Theorem: state-p1-of-load-file-into-memory.state

(defthm state-p1-of-load-file-into-memory.state
  (implies (and (stringp filename)
                (state-p1 state))
           (b* (((mv ?file-contents ?x86 acl2::?state)
                 (load-file-into-memory filename ptr x86 state)))
             (state-p1 state)))
  :rule-classes :rewrite)