Nios® II Software Developer Handbook

ID 683525
Date 8/28/2023
Public
Document Table of Contents

16.1.15. nios2-elf-query

Usage

Simple ELF 'querying' tool used to extract metadata inserted into an ELF intended for the Nios® II soft-core processor. The main purpose of this tool is so that downstream tools can extract information from an ELF that was inserted using nios2-elf-insert. The main motivation for this tool is to make the ELF file the single handoff file that all downstream embedded tools can agree on.

For example, the Nios® II SBT build flow uses nios-elf-insert to insert the cpu name and the sysid information into the ELF file at build time. Later on downstream, the eclipse debugger can use nios2-elf-query to extract this information to auto-populate all the various GUI settings with the correct default values.

The first argument is the ELF filename: (nios2-elf-query <filename>).

Valid Additional Arguments

--qsys
--cpu_name
--stderr_dev
--stdin_dev
--stdout_dev
--sidp
--id
--timestamp
--sof
--sopcinfo
--jar
--jdi
--quartus_project_dir
--sopc_system_name
--profiling_enabled
--simulation_enabled
--thread_model

Advanced Options

--jvm-max-heap-size=<value>—Optional. The maximum memory size to be used for allocations when running this tool. This value is specified as <size><unit> where unit can be m (or M) for multiples of megabytes or g (or G) for multiples of gigabytes. The default value is 512m.