add prefetch item

This command adds a download item to the prefetch queue. This command must reside between a begin prefetch block and an end prefetch block command. This command can specify multiple downloads separated by semicolons.

Version Platforms
8.0.584.0 AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows
8.1.535.0 Debian, Ubuntu


add prefetch item [name=<name>] [sha1=<sha1>] [sha256=<sha256>] size=<size> url=<url> [; ...] 


  • name is an optional file name for the download. If no name is specified, it will be automatically determined from the URL.
  • sha1 is an optional SHA-1 of the file.
  • sha256 is an optional SHA-256 of the file.
  • size is the size of the file in bytes.
  • url is the URL of the file.

At least one of sha1 or sha256 must be present. To download a file without specifying a hash, use the add nohash prefetch item command.

The arguments may be in any order, and unrecognized arguments will be ignored.


This example demonstrates a conditional download in a prefetch block. By checking the OS first, only the proper file will be prefetched, potentially saving time and bandwidth.

begin prefetch block
if {name of operating system = "Windows 2000"}
add prefetch item {"name=up.exe sha1=12 size=45 url="}
add prefetch item {"name=up.exe sha1=12 size=45 url="}
end prefetch block
wait {download path "up.exe"}


Relevance substitution is allowed with the arguments of this command. However when substitution is used, the BigFix Server can't cache the download item at action creation time.

Instead of listing the download items in the command line, you can put them in a file (one item per line) and then use a relevance substitution like the following:

begin prefetch block
add prefetch item {concatenation ";" of lines of file my-downloads.txt}
end prefetch block