Everything
2.4.2 Subcommand file usage

A subcommand file is a file that options and file names specified for a command are described.

The command treats the contents of a subcommand file as if they were command-line arguments.

Use a subcommand file when the arguments will not fit on the command line, or when same options are specified repeatedly each time the command is executed.

(1)

Using a subcommand file for the compiler and assembler

(a)

Cautions about description of a subcommand file

-

The arguments to be specified can be coded over several lines.
However, you cannot start a new line within the name of the option or file.

-

When the subcommand option is specified in a subcommand file, the same file name as the current subcommand file cannot be specified in the subcommand option.

-

The character code contents of a subcommand file cannot be specified by using the -Xcharacter_set option.
If you use characters other than ASCII in the subcommand file, use the UTF-8 file with BOM.

-

The following characters are treated as special characters.
These special characters themselves are not included in the command line of the ccrh command and deleted.

" (double quotation mark)

The character string until the next double quotation mark is treated as a contiguous character string.

# (sharp)

If this is specified at the beginning of a line, the characters on that line before the end of the line are interpreted as a comment.

^ (circumflex)

The character immediately following this is not treated as a special character.

(b)

Example of subcommand file specification

Create subcommand file "sub.txt" using an editor.

-Xcommon=rh850
-c
-Dtest
-Idir
-Osize

 

Specify sub.txt by subcommand file specification option "@" on the command line.

>ccrh @sub.txt -ofile.obj file.c

 

The command line is expanded as follows.

>ccrh -Xcommon=rh850 -c -Dtest -Idir -Osize -ofile.obj file.c

(2)

Using a subcommand file for the optimizing linker

(a)

Cautions about description of a subcommand file

-

The leading hyphen ("-") on option names can be omitted.

-

A space can be used in place of the equals sign ("=") as the delimiter between the option and parameter.

-

Specify one option per one line.
If the command line cannot fit on a single line, you can use the ampersand ("&") to span multiple lines.

-

The subcommand option cannot be specified in a subcommand file. [V1.04.00 or earlier]

-

When the subcommand option is specified in a subcommand file, the same file name as the current subcommand file cannot be specified in the subcommand option. [V1.05.00 or later]

-

The following characters are treated as special characters.
These special characters themselves are not included in the command line of the rlink command and deleted.

& (and)

The following line will be treated as a continuation.

; (semicolon)

The characters on that line before the end of the line are interpreted as a comment.

(b)

Example of subcommand file specification

Create subcommand file "sub.txt" using an editor.

input file2.obj file3.obj       ; This is a comment.
library lib1.lib, &             ; This is a line continued.
lib2.lib

 

Specify sub.txt by subcommand file specification option "-subcommand" on the command line.

>rlink file1.obj -subcommand=sub.txt file4.obj

 

The command line is expanded as follows.

>rlink file1.obj file2.obj file3.obj -library=lib1.lib,lib2.lib file4.obj