ANCILLARY Directive

The ANCILLARY directive is used to create ancillary object files, to contain the section data for non-allocable sections. Such sections are not needed at runtime, and typically provide supplemental information to debuggers and other observability tools. See Ancillary Objects.

        ANCILARY {
anc_name {
                        FILE_PATH  = [file_path];
                        FILE_SUFFIX  = [file_suffix];
                };
        };

An ancillary file is created for each entry of the ANCILLARY directive. Each is identified within mapfiles by the unique anc_name. The NULL_SEGMENT directive can then be used to direct selected sections to each anc_name. See ASSIGN_SECTION Attribute (LOAD, NOTE, NULL).

If no output file name is specified with the FILE_PATH or FILE_SUFFIX attribute, the link-editor generates a default name, based on the name specified for the primary output object file, as follows.

• For the first ancillary object, if a name was specified with the -z ancillary command line option, the specified name is used. If a name was not specified on the command line, a name is generated by appending the suffix .anc to the primary output file name.

• For the second and subsequent ancillary object, the file name is generated by appending the anc_name, followed by .anc, to the primary output file name.