{{TableOfContents}}

This is an index of all the variables used by Fuego:

{{{#!YellowBlock
FIXTHIS - I don't have all the fuego variables documented here yet

See also [[Core interfaces]]
}}}

= A =
 * ARCHITECTURE: the processor architecture of the target board
   * defined in the board file for a target
   * used by toolchain and build scripts for building the tests
     * ''NOTE: this appears to only be used by iozone.sh''
   * sample: arm
 * ARCH: architecture used by the toolchain
   * sample: arm
   * set by [[tools.sh]] based on PLATFORM
 * AS: name of the assembler
   * set by [[tools.sh]] based on PLATFORM
   * commonly used during the build phase (in the function [[function_test_build|test_build]])

= B =
 * BAUD : Baud rate to be used with the serialport
   * defined in the board file for a target
   * used by serial transport
   * sample: "115200"
 * BOARD_TESTDIR : directory on the target board where test data will be placed
   * defined in the board file for a target
   * sample: "/home/fuego"


= C =
 * CC: name of the C compiler
   * set by [[tools.sh]] based on PLATFORM
   * commonly used during the build phase (in the function [[function_test_build|test_build]])
   * sample: arm-linux-gnueabihf-gcc
 * CONFIGURE_FLAGS: flags used with the 'configure' program
   * set by [[tools.sh]] based on PLATFORM
   * commonly used during the build phase (in the function [[function_test_build|test_build]])
 * CROSS_COMPILE: cross-compile prefix used for kernel builds
   * set by [[tools.sh]] based on PLATFORM
   * sample: arm-linux-gnueabihf-
   * NOTE: this is often $PREFIX followed by a single dash
 * CPP: name of the C pre-processor
   * set by [[tools.sh]] based on PLATFORM
 * CXX: name of the C++ compiler
   * set by [[tools.sh]] based on PLATFORM
 * CXXCPP: name of the C++ pre-processor
   * set by [[tools.sh]] based on PLATFORM

= F =
 * FUEGO_ENGINE_PATH: root directory for fuego system (the "engine")
   * sample: /home/jenkins
 * FUEGO_HOME: home directory on the target that fuego uses for operations
   * sample: /home/a
 * FUEGO_LOG_PATH: root directory for test logs
   * sample: /home/jenkins/logs
 * FUEGO_PARSER_PATH: root directory for fuego parser system
   * sample: /home/jenkins/scripts/parser
 * FUEGO_SCRIPTS_PATH: root directory for fuego scripts
   * sample: /home/jenkins/scripts
 * FUEGO_TESTS_PATH: root directory for fuego tests directories
   * sample: /home/jenkins/tests

= G =
 * GEN_TESTRES_FILE: set to the value of TEST_RES, when a BATCH_TESTPLAN is in effect

= I =
 * IO_TIME_SERIAL: Time required for echoing the whole command and response
   * defined in the board file
   * used by the transport functions
   * sample: 0.1
 * IPADDR: IP address of the target board
   * defined in the board file
   * used by the transport functions
   * sample: 10.0.1.74


= L =
 * LD: name of the linker
   * set by [[tools.sh]] based on PLATFORM
   * sample: arm-linux-gnueabihf-ld
 * LOGIN: login account name for the target
   * defined in the board file for the target
   * used by the transport functions
   * the account on the target should have sufficient rights to run a variety of tests and perform a variety of operations on the target
   * sample: root

= M =
 * MMC_DEV: device filename for an MMC device on the target
   * defined in the board file
   * used by filesystem test specs
   * sample: /dev/mmcblk0p2
 * MMC_MP: mount point for a filesystem on an MMC device on the target
   * defined in the board file
   * used by filesystem test specs
   * sample: /mnt/mmc
 * MOUNT_BLOCKDEV: device filename for a block device on the target
   * defined in a filesystem test spec
     * e.g. in (bonnie, fio, ffsb, iozone, synctest, aiostress, dbench, tiobench).spec
   * usually references either MMC_DEV, SATA_DEV or USB_DEV, depending on what the test spec indicates to test
   * sample: /dev/sda1
 * MOUNT_POINT: mount point for a filesystem to be tested on the target
   * defined in a filesystem test spec
      * e.g. in (bonnie, fio, ffsb, iozone, synctest, aiostress, dbench, tiobench).spec
   * usually references either MMC_MP, SATA_MP, or USB_MP, depending on what the test spec indicates to test
   * sample: /mnt/sata

= O =
 * OF_ROOT: root of overlay system
   * sample: /home/jenkins/overlays/

= P =
 * PASSWORD: password used with to login to the target board
   * defined in the board file for a target
   * used by the transport functions
   * it can be the empty string: ""
   * sample: mypass
 * PLATFORM: name of the target "platform"  This is used to identify the toolchain used for building tests
   * defined in the board file
   * used in tools.sh
   * sample: qemu-armv7hf
 * PREFIX: toolchain prefix
   * set by [[tools.sh]] based on PLATFORM
   * sample: arm-linux-gnueabihf
   * NOTE: see also CROSS_COMPILE



= R =
 * REP_DIR: directory where reports are stored
   * sample: /home/jenkins/logs/logruns/
 * REP_GEN: report generator program
   * sample: /home/jenkins/scripts/loggen/gentexml.py
 * REP_LOGGEN: program used to generate report logs?
   * sample: /home/jenkins/scripts/loggen/loggen.py

= S =
 * SATA_DEV: device node filename for a SATA device on the target
   * defined in the board file
   * used by filesystem tests
   * sample: /dev/sda1
 * SATA_MP: mount point for a filesystem on a SATA device on the target
   * used by filesystem tests
   * sample: /mnt/sata
 * SRV_IP: IP address of server machine (host machine where fuego runs)
   * defined in base-board.fuegoclass
     * obtained dynamically using the 'ip' command
   * can be defined in a board file for a target, using an 'override' command
   * used by networking tests (NetPIPE, iperf, netperf)
   * sample: 10.0.1.1
 * SSH_PORT: port to use for ssh connections on the target
   * defined in the board file for the target
   * the default port for sshd is 22
   * sample: 22
 * SERIAL: port to use for serial connections on the target
   * defined in the board file for the target
   * The device file name as detected in Docker container 
   * sample: ttyACM0

= T =
 * TESTLOG: full path to log for a particular test
   * sample: /home/jenkins/logs/Functional.bzip2/testlogs/bbb.2016-06-24_18-12-53.2.log
 * TEST_RES: full path to JSON results file for a test
   * sample: /home/jenkins/logs/Functional.bzip2/testlogs/bbb.2016-06-24_18-12-53.2.res.json
   * sample contents: 
 * TESTDIR: name of the directory for a particular test
   * this is just the directory name, not the full path (see $TEST_HOME)
   * this is also used as the reference parse log prefix
   * sample: Functional.bzip2
 * TEST_HOME: full path to the root of the test directory
   * sample: /home/jenkins/tests/Functional.bzip2
different platforms
 * TRANSPORT: type of connection between the host system and the target system
   * defined in the board file for the target
   * possible values: ssh, serial, ttc
     * others anticipated are: adb, lava
   * used by the transport functions
   * sample: ssh
 * TTC_TARGET: target name used with 'ttc' command
   * defined in the board file for the target
   * used by the transport functions, for the 'ttc' transport only
   * sample: beaglebone




= U =
 * USB_DEV: device filename for an block device provided by a USB device on the target
   * defined in the board file
   * used by filesystem test specs
   * sample: /dev/sdb1
 * USB_MP: mount point for a filesystem on an USB device on the target
   * defined in the board file
   * used by filesystem test specs
   * sample: /mnt/usb


= UNDOCUMENTED (YET) =
 * TRIPLET
 * LTP_OPEN_POSIX_SUBTEST_COUNT_POS
   * defined in board file for a target
 * LTP_OPEN_POSIX_SUBTEST_COUNT_NEG
   * defined in board file for a target
 * EXPAT_SUBTEST_COUNT_POS
   * defined in board file for a target
 * EXPAT_SUBTEST_COUNT_NEG
   * defined in board file for a target
 * OF_ROOT
 * OF_CLASSDIR
 * OF_DEFAULT_SPECDIR
 * OF_OVFILES
 * OF_CLASSDIR_ARGS
 * OF_TESTPLAN_ARGS
 * OF_SPECDIR_ARGS
 * OF_OUTPUT_FILE
 * OF_OUTPUT_FILE_ARGS
 * OF_DISTRIB_FILE
 * OF_OVGEN
 * OF_BOARD_FILE
 * BATCH_TESTPLAN
 * OF_TESTPLAN
 * OF_TESTPLAN_ARGS
 * OF_OVFILES_ARGS