Editing C&I Wiki Portal/ToolsDevelopmentGuideline (section)

==== Whitelists ====
Whitelists are text lists that define the test suite.  This is a list of tests to run.  Below is a sample whitelist:
<pre>
# Resource Jobs
miscellanea/submission-resources
#Info attachment jobs
__info__
cpuinfo_attachment
dmesg_attachment
dmi_attachment
dmidecode_attachment
efi_attachment
lspci_attachment
lshw_attachment
mcelog_attachment
meminfo_attachment
modprobe_attachment
modules_attachment
sysctl_attachment
sysfs_attachment
udev_attachment
lsmod_attachment
acpi_sleep_attachment
info/hdparm
info/hdparm_.*.txt
installer_debug.gz
info/disk_partitions
# Actual test cases
__TC-003__
TC-003-0003-001/Network_performance
TC-003-0003-001/Network_performance_.*
</pre>

The first job, '''miscellanea/submission-resources''' is always required in a whitelist.  It is what triggers all the various resource jobs to run as well as jobs necessary to create a full submission file.  After that, add whatever jobs you need.  The first group in the example above are jobs that attach files containing the output of various commands. 

In the next section is an example of two things.  The job '''TC-003-0003-001/Network_performance''' is a "metajob" that generates other jobs.  IN this case, it's a job that creates a separate network test for each NIC discovered on the SUT.  The next job, '''TC-003-0003-001/Network_performance_.*''' is an example of using a regular expression.  In this case, this line item tells Checkbox to run any job that starts with the text 'TC-003-0003-001/Network_performance_' (which when run would be jobs like 'TC-003-0003-001/Network_performance_eth0' and 'TC-003-0003-001/Network_performance_eth1'.