FILEREF

The (NO)FILEREF option controls whether the compiler produces a file reference table. The NOFILEREF option eliminates the file reference table from the listing if the compiler issues no messages for the specified FLAG setting.

The HASH suboption of the FILEREF option specifies that each line in the file reference table is followed by a line containing the hex value of a 256-bit SHA-2 hash of that file.

The compiler will perform this hash by invoking the SHA2INIT256 built-in function when it opens a file. It will then use the token returned by that function to invoke the SHA2UPDATE256 built-in function after it reads each line in the file and to invoke the SHA2FINAL256 built-in function after it closes the file.

When hashing the file, the compiler will widen any line shorter than the right margin by filling it with blanks.

This hash value is the same value that will appear in the generated xml file if the XINFO(XML(HASH)) option is specified.

The default is FILEREF(NOHASH).