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
|