19.2.14. Command-line overview

Command-line arguments provide all model configuration. Run the model with --help to obtain a summary of the available commands.

The syntax to use on the command line is:

./Foundation_v8 [OPTIONS...]

Table 19.1 shows the options.

Table 19.1. Command-line options

--helpDisplay this help message and quit.
--versionDisplay the version and build numbers and quit.
--quietSuppress any non-simulated output on stdout or stderr.
--cores=NSpecify the number of cores, where N is 1 to 4. The default is 1. See Multicore configuration.
--bigendianStart processors in big endian mode. The default is little endian.
--(no-)secure-memoryEnable or disable separate Secure and Non-secure address spaces. The default is disabled.
--(no-)gicv3Enable GICv3 or legacy compatible GICv2 as interrupt controller. The default is --no-gicv3, that is, GICv2 mode.
--block-device=fileImage file to use as persistent block storage.
--read-onlyMount block device image in read-only mode.
--image=fileExecutable and Linking Format (ELF) image to load.
--data=file@addressRaw file to load at an address in Secure memory.
--nsdata=file@addressRaw file to load at an address in Non-secure memory.
--(no-)semihostEnable or disable semihosting support. The default is enabled. See Semihosting.
--semihost-cmd=cmdA string used as the semihosting command line. See Semihosting.
--uart-start-port=PAttempt to listen on a free TCP port in the range P to P+100 for each UART. The default is 5000.
--network=(none|nat|bridged)Configure mode of network access. The default is none.
--network-nat-subnet=SSubnet used for NAT networking. The default is 172.20.51.0/24.
--network-nat-ports=MOptional comma-separated list of NAT port mappings in the form: host_port=model_port, for example, 8022=22.
--network-mac-addressMAC address to use for networking. The default is 00:02:f7:ef:f6:74.
--network-bridge=devBridged network device name. The default is ARM0.
--switches=valInitial setting of switches in the system register block (default: 0).
--(no-)visualizationStarts a small web server to visualize platform state. The default is disabled. See Web interface.
--use-real-timeSets the generic timer registers to report a view of real time as it is seen on the host platform, irrespective of how slow or fast the simulation is running.
--p9_root_dirHost folder to be shared with the guest.

If more than one --image, --data, or, --nsdata option is provided, the images and data are loaded in the order that they appear on the command line, and the simulation starts from the entry point of the last ELF specified, or address 0 if no ELF images are provided. You can specify more than one --image, --data or --nsdata option.

Copyright © 2015 ARM. All rights reserved.ARM DEN0024A
Non-ConfidentialID050815