The BootRefFile processor is used for operations related to ref-value files on this wiki. It handles a few different operations:

• Shows a list of files, with links to operatons to add or remove a ref-value file symlink for that file.
• Shows the matching scores for a list of boot-data files, relative to a specified boot-data file
• Check to see if a boot-data file, or ref-value file is present in the wiki file download area
• Query for matching scores for boot-data files, relative to a specified boot-data file (this is provided via a web API used by find-matching-ref-value-file.py

Boot data reference files have the same format as boot-time data files, but their filenames include the string "ref-values" immediately before the ".txt" file suffix.

When called on a page, if the processor block contains a boot-data filename, it returns data about the scores of all ref files, and the best match, from all available ref files, for doing regression testing analysis for the specified file.

If no boot-data filename is specified in the block, then a list of files is shown (matching the 'match' regular expression, if one is provided), along with links to manage the ref-value file symlink for that boot-data file.

Processor arguments are:

• bd_file={filename} - boot data file to match
• match={regex} - regular expression to match filenames for, for operations.
• match_prefs={item[,item...]} - list of items passed as arguments with -m to find-matching-ref-value-file.py Supported options are: 'same-lab' and 'same-machine' Note that the match pref of 'not-self' is always applied.

Example usage:

{{{#!BootRefFile
bd_file=boot-data-timslab-bp1-250123-184721.txt
}} }

This shows scores for all boot-data files besides the one mentioned.

Example usage:

{{{#!BootRefFile
match=boot-data-timslab-bp1.*
}} }

This shows a table of files, with links to operations that can be performed on them (e.g. remove a ref value file symlink, or add one).

To use this processor to find a reference value file for testing purposes, use the 'query' action. You can do this with a URL as follows: curl https://birdcloud.org/boot-time/FrontPage?action=BootRefFile.query&bd_file={filename}&count=999 What you get in return will be a single line indicating status, and a list of URLS and scores, sorted by highest score at the top. The count argument indicates a maximum number of entries to return.

Back to page: System_Info