Options for outputting listings and CIF information

-N binder[,file]

This option, which is analogous to the MAP operand of the BINDER statement SAVE-LLM, can be used to request the standard listings of BINDER. These listings are created only when an executable file or a prelinked object file (-r) is generated. If file is not specified, the BINDER listings are written to an output file file.lst, where file is the name of the executable or the prelinked object file (a.out or the name defined with the -o option). file can be used to specify some other output file name. The -N binder option is ignored if specified in combination with any of the options -c, -E, -M, -P or -y.

-N cif,[output-spec],consumer1[,consumer2 ...]

(output-spec is a file or a directory).
The compiler generates a CIF (Compilation Information File) containing information for the specified consumers. If output-spec is not specified, the CIF is written into a separate file named sourcefile.cif for each compiled source file. A different output file name can be defined with output-spec. In this case, only one source file can be compiled. The global listing generator cclistgen is provided to further process the generated CIF information (see "Global listing generator (cclistgen)").
The following entries can be made for consumer:

option or lo (options)

prepro or lp (result of the preprocessor)

source_error or ls (errors in the source program)

data_allocation_map or lm (addresses)

cross_reference or lx or xref (references)

object or la (object code)

project or lP (project information, only with the CC command)

summary or lS (statistics)

ALL

If ALL is specified, all possible CIF information is generated, e.g. when the compiler run is terminated after the preprocessor phase (-E, -P options), CIF information for an options, preprocessor and statistics listing. The CIF may be very large if ALL is specified!

-N listing1[,listing2...]

The compiler writes the listings requested with this option either into a separatesourcefile.lst file for each compiled source file or for all compiled source files into the listing file file specified with the -N output option.
When the maximum number of errors is reached (controlled by -R limit), no source program information will be output to the source/error list. At this point the source/error list can no longer taken as a reliable guide to real error status.
The following entries are possible for listing:

option or lo (options listing)

prepro or lp (preprocessor listing)

source_error or ls (source program/error listing)

data_allocation_map or lm (map listing)

cross_reference or lx (cross-reference listing, see also the -N xref option)

object or la (object listing)

project or lP (project listing, only with the CC command)

summary or lS (statistics listing)

ALL

If ALL is specified, all possible CIF information is generated, e.g. when the compiler run is terminated after the preprocessor phase (-E, -P options), an options, preprocessor and statistics listing.

-N map_structlevel,n

This option controls the nesting level up to which structure elements are included in the list requested with the option -N data_allocation_map. Values from 0 to 256 inclusively can be specified for n.
Structure elements up to the nesting level specified by n are represented in the map listing. If a nesting level of 0 is specified, no structure elements are output.

Examples for the structure of compiler listings can be found in the section “Description of listings” of the C/C++ User Guide [4].

-N output[,[output-spec][,layout][,[lpp][,cpl]]]

This option can be used to specify the name of the output file (output-spec) or output directory in which the compiler listings for all source files are to be written.
If output-spec is not specified, a separate listing file sourcefile.lst is generated for each compiled source file.
If output-spec specifies an existing output directory, the name output-spec/sourcefile.lst is assigned by default. If this is not the case, the name output-spec is interpreted as the file name.

The following entries can be made for layout:

normal or for_normal_print (default)
The default page length is 64 lines and the line width 132 characters.

rotation or for_rotation_print
The page length for the compiler listing is defined as 84 lines and the line width as 120 characters.

lpp can be used to define a page length of from 11 to 255 lines per page.

cpl can be used to define a line width of from 120 to 255 characters per line.

Note

Since the output file is prepared for printing under POSIX, there are up to 3 control characters at the beginning of some lines in the file. In addition, every line is terminated with the printer control character for a carriage return. If the output file is printed out, then the line length is cpl–1.

-N title,text

This operand can be used to specify if an additional line is to appear in the header of the listing and the text that is to be entered in it. In contrast to pragmas, which only apply to source and preprocessor listings, the -N title option applies to all compiler listings. In order to ensure that the desired text is transferred correctly, it is advisable to enter it within quotes ("text"). In the case of source and preprocessor listings, TITLE and PAGE pragmas (if any) override the -N title specification. See also the section on “Pragmas to control the layout of listings” in the C/C++ User Guide [4].

-N xref,xrefopt1[,xrefopt2...]

The sections contained in the cross-reference listing requested with
-N cross_reference can be controlled with this option.
If the -N xref option is not specified, the cross-reference listing contains a list of the variables, functions and labels (equivalent to -N xref,v,f,l).
The cross-reference listing always contains a FILETABLE section containing the names of all files, libraries and members that the compiler used as sources.

If the -N xref option is specified, the cross-reference listing only contains the FILETABLE section and the sections requested with the xrefopt argument:

p	List of the names processed by the preprocessor in #include and #define statements
y	List of the user-defined types (typedefs, structure, union, classes and counter types)
v	List of variables
f	List of functions
l	List of labels
t	List of templates (only with C++ compilations)
o=str	The order in which the separate sections are listed in the cross-reference listing. str is a string of up to 6 characters (letters for the lists shown above). The default is the order as shown above (i.e., o=pyvflt). If the order specified with o=str does not include all letters for the listings requested with -N xref, the omitted letters are implicitly appended to the end of str in the default order shown above.

-K arg1[,arg2...]

General input rules for the -K option can be found on "Calling syntax and general rules (C/C++ POSIX Commands, #26)".
The following entries are possible as arg arguments to control the listing output:

include_user
include_all
include_none

These arguments control whether and which header files are mapped to the source program, preprocessor and cross-reference listings.

-K include_user is the default and only maps the user header files.

If -K include_all is specified, all header files are mapped, i.e. the standard header files and those of the user.

If -K include_none is specified, no header files are mapped.

cif_include_user
cif_include_all
cif_include_none

These arguments control whether and from which header files (also called include files) the CIF information for source/error, preprocessor and cross-reference listings is to be generated.

-K cif_include_user is the default and causes only the user-defined header files to be considered in the CIF.

If -K cif_include_all is specified, all header files, i.e., the standard headers and the user-defined headers, are considered in the CIF.

If -K cif_include_none is specified, none of the header files are considered in the CIF.

pragmas_interpreted
pragmas_ignored

These arguments control whether #pragma directives for controlling the layout of listings are evaluated (see also the section “Pragmas to control the layout of listings” in the C/C++ User Guide [4]).
-K pragmas_interpreted is the default.