3.1 Command-line options

Command-line options provide all platform configuration. Run the platform with --help to see a summary of the available commands.

The syntax to use on the command line is:

./Foundation_Platform [OPTIONS...]

Table 3-1 Command-line options

--arm-v8.n Enable the Arm®v8.n version of the architecture, where 0 <= n <= 4. The default is --arm-v8.4.
--bigendian Start processors in big-endian mode. The default is little-endian.
--block-device=file Image file to use as persistent block storage.
--cadi-server Start the CADI server. This option allows debuggers to connect to targets in the simulation.
--cores=N Specify the number of processors, where N is in the range 1-4. The default is 1.
--(ns)data=file@address Raw file to load at an address in non-secure or secure memory.
--(no-)gicv3 Enable GICv3 or the legacy, compatible GICv2. The default is --gicv3.
--help Display the command-line options and quit.
--image=file ELF image to load.
--network=(none|nat|bridged) Configure mode of network access. The default is none.
--network-bridge=dev Bridged network device name. The default is ARM0.
--network-mac-address MAC address to use for networking. The default is 00:02:f7:ef:f6:74.
--network-nat-ports=M Optional comma-separated list of NAT port mappings in the form: host_port=model_port, for example, 8022=22.
--network-nat-subnet=S Subnet used for NAT networking. The default is 172.20.51.0/24.
--p9_root_dir=dir Host folder to be shared between the host and the guest.
--print-port-number Print the port number that the CADI server is listening to.
--quiet Suppress any non-simulated output on stdout or stderr.
--(no-)rate-limit Restrict simulation speed so that simulation time more closely matches real time rather than running as fast as possible. The default is disabled.
--read-only Mount block device image in read-only mode.
--(no-)secure-memory Enable or disable separate secure and non-secure address spaces. The default is disabled.
--(no-)semihost Enable or disable semihosting support. The default is enabled.
--semihost-cmd=cmd A string that is used as the semihosting command line.
--semihosting-heap_base=address Virtual address of the heap base. The default is 0.
--semihosting-heap_limit=address Virtual address of the top of the heap. The default is 0xFF000000.
--semihosting-stack_base=address Virtual address of the base of the descending stack. The default is 0xFFFF0000.
--semihosting-stack_limit=address Virtual address of the stack limit. The default is 0xFF000000.
--(no-)sve Enable or disable Scalable Vector Extension (SVE). The default is enabled. This option requires Armv8.2 or a later architecture to be enabled.
--switches=val Initial setting of switches in the system register block. The default is 0.
--uartN-outfile=file Redirect output from UARTN to a file, where N is in the range 0-3. Specify a filename of - to redirect output to stdout. If no filename is specified, the option is ignored.
--uart-start-port=P Attempt to listen on a free TCP port in the range P to P+100 for each UART. The default is 5000.
--use-real-time Sets the generic timer registers to report a view of real time as it is seen on the host platform. The generic timer registers are irrespective of how slow or fast the simulation runs.
--version Display the version and build numbers and quit.
--(no-)visualization Starts a small web server to visualize the platform state. The default is disabled.

You can specify more than one --image, --data, or --nsdata option. The images and data are loaded in the order that they appear on the command line. The simulation starts from the entry point of the final ELF file specified.

Non-ConfidentialPDF file icon PDF version100961_1180_00_en
Copyright © 2012–2019 Arm Limited or its affiliates. All rights reserved.