[Create Library Options] tab


This tab shows the detailed information on the create library phase categorized by the following and the configuration can be changed.

 

(1) [Debug Information]

(2) [Input File]

(3) [Output File]

(4) [Library]

(5) [List]

(6) [Message]

(7) [Others]

Caution

This tab is displayed for the library project.

Figure A.7

Property Panel: [Create Library Options] Tab

[Description of each category]

(1)

[Debug Information]

The detailed information on debug information is displayed and the configuration can be changed.

Output debug information

Select whether to output debug information.

This property corresponds to the -DEBug and -NODEBug options of the rlink command.

This property is displayed only when [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category.

Default

Yes(Output to the output file)(-DEBug)

How to change

Select from the drop-down list.

Restriction

Yes(Output to the output file)(-DEBug)

Outputs debug information.

No

Does not output debug information.

Delete local symbol name information

Select whether to delete local symbol name information.

This property corresponds to the -Hide option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-Hide)

Deletes information of the local symbol name.

No

Does not delete information of the local symbol name.

(2)

[Input File]

The detailed information on input files is displayed and the configuration can be changed.

Object file

Specify the object files.

Specify in the format of "library(module)", with one entry name per line.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

This property corresponds to the -Input option of the rlink command.

The object file name is displayed as the subproperty.

Default

Object file[number of defined items]

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 1024 characters

Up to 256 items can be specified.

Binary file

Specify the binary files.

Specify in the format of "file name(section name[:number of alignment][/section attribute][,symbol name])", with one entry per line.

[:number of alignment], [/section attribute], and [,symbol name] can be omitted.

The value that can be specified for number of alignment is 1, 2, 4, 8, 16, or 32.

If the specification is omitted, it is assumed that 1 has been specified.

"CODE" or "DATA" can be specified as section attribute.

If the specification is omitted, all attributes such as the ability to write, read, and execute, will be all valid.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

This property corresponds to the -Binary option of the rlink command.

The binary file name is displayed as the subproperty.

This property is displayed only when [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category.

Default

Binary file[number of defined items]

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 1024 characters

Up to 256 items can be specified.

(3)

[Output File]

The detailed information on output files is displayed and the configuration can be changed.

Output file format

Select the format of the output file.

This property corresponds to the -FOrm option of the rlink command.

Default

User libraries(-FOrm=Library=U)

How to change

Select from the drop-down list.

Restriction

User libraries(-FOrm=Library=U)

Outputs a user library file.

System libraries(-FOrm=Library=S)

Outputs a system library file.

Relocatable file(-FOrm=Relocate)

Outputs a relocatable file.

Output folder

Specify the output folder.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

If this is blank, it is assumed that the project folder has been specified.

This property corresponds to the -OUtput option of the rlink command.

Default

%BuildModeName%

How to change

Directly enter in the text box or edit by the Browse For Folder dialog box which appears when clicking the [...] button.

Restriction

Up to 247 characters

Output file name

Specify the output file name.

If the extension is omitted, it is automatically added according to the selection in the [Output file format] property.

When [User libraries(-FOrm=Library=U)] is selected: .lib

When [System libraries(-FOrm=Library=S)] is selected: .lib

When [Relocatable file(-FOrm=Relocate)] is selected: .rel

The following placeholders are supported.

%ActiveProjectName%: Replaces with the active project name.

%MainProjectName%: Replaces with the main project name.

%ProjectName%: Replaces with the project name.

This property corresponds to the -OUtput option of the rlink command.

Default

%ProjectName%.lib

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

(4)

[Library]

The detailed information on the library is displayed and the configuration can be changed.

Using libraries

Specify the library files to be used.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

This property corresponds to the -LIBrary option of the rlink command.

The library file name is displayed as the subproperty.

Default

Using libraries[number of defined items]

How to change

Edit by the Path Edit dialog box which appears when clicking the [...] button.

-> Edit by the Specify Using Library File dialog box which appears when clicking the [Browse...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 259 characters

Up to 65536 items can be specified.

System libraries

The system library files are displayed.

This property corresponds to the -LIBrary option of the rlink command.

The system library file name is displayed as the subproperty.

Default

System libraries[number of defined items]

How to change

Changes not allowed

Use standard libraries

Select whether to use the standard libraries provided by the compiler.

This property corresponds to the -LIBrary option of the rlink command.

[Yes(V1.01 compatible)] is displayed when [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Uses the standard libraries.

Yes(V1.01 compatible)

Uses the libraries compatible with CC-RH V1.01.

No

Does not use the standard libraries.

Use "Standard Library" function

Select whether to use the standard library functions.

This property is changed to [Yes(-LIBrary=libc)] when [Yes] in the [Use "Mathematical Library (Double precision)" function] or [Use "Mathematical Library (Single precision)" function] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libc)

Uses the standard library functions.

No

Does not use the standard library functions.

Use "Mathematical Library (Double precision)" function

Select whether to use the mathematical library (double precision) functions.

This property is changed to [No] when [No] in the [Use standard libraries] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libm)

Uses the mathematical library (double precision) functions.

No

Does not use the mathematical library (double precision) functions.

Use "Mathematical Library (Single precision)" function

Select whether to use the mathematical library (single precision) functions.

This property is changed to [No] when [No] in the [Use standard libraries] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libmf)

Uses the mathematical library (single precision) functions.

No

Does not use the mathematical library (single precision) functions.

Use "Standard/Mathematical Library" function

Select whether to use the standard/mathematical library functions.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes] in the [Use standard libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Uses the standard/mathematical library functions.

No

Does not use the standard/mathematical library functions.

Check memory smashing on releasing memory

Selects whether to check memory smashing on releasing the memory.

This property is usable only in the Professional Edition.

The user-defined __heap_chk_fail() function is called if an illegal address has been specified or an address outside the allocated memory area has been written to when the memory that was dynamically allocated by malloc or another function is released or re-allocated by this function. See "CC-RH Compiler User's Manual" for details.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed only in the following cases.

-

When [Always latest version which was installed] or V1.04.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V1.04.00 or a later version of the CC-RH compiler has been installed

-

When [Yes] in the [Use standard/mathematical libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Checks memory smashing on releasing the memory.

No

Does not check memory smashing on releasing the memory.

Use "Non-local jump Library" function

Select whether to use the non-local jump library functions.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed only when other than [No] in the [Use standard libraries] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libsetjmp)

Uses the non-local jump library functions.

No

Does not use the non-local jump library functions.

(5)

[List]

The detailed information on the list is displayed and the configuration can be changed.

Output link map file

Select whether to output the library list file.

This property corresponds to the -LISt and -SHow options of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(List contents=not specify)(-LISt -SHow)

Outputs information according to the output format to the library list file.

Yes(List contents=ALL)(-LISt -SHow=ALL)

Outputs all information according to the output format to the library list file.

Yes(List contents=specify)(-LISt)

Outputs the specified information to the library list file.

No

Does not output the library list file.

Output symbol information

Select whether to output the symbol information (symbol names within a module).

This property corresponds to the -SHow=SYmbol option of the rlink command.

This property is displayed only when [Yes(List contents=specify)(-LISt)] in the [Output link map file] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-SHow=SYmbol)

Outputs the symbol information.

No

Does not output the symbol information.

Output section list in a module

Select whether to output the list of the section names within the module.

This property corresponds to the -SHow=SEction option of the rlink command.

This property is displayed only when [Yes(List contents=specify)(-LISt)] in the [Output link map file] property is selected and [User libraries(-FOrm=Library=U)] or [System libraries(-FOrm=Library=S)] in the [Output file format] property in the [Output File] category is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-SHow=SEction)

Outputs the list of the section names within the module.

No

Does not output the list of the section names within the module.

Output cross reference information

Select whether to output the cross reference information.

This property corresponds to the -SHow=XReference option of the rlink command.

This property is displayed only when [Yes(List contents=specify)(-LISt)] in the [Output link map file] property and [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category are selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-SHow=Xreference)

Outputs the cross reference information.

No

Does not output the cross reference information.

Output total sizes of sections

Select whether to output the total size of sections.

This property corresponds to the -SHow=Total_size option of the rlink command.

This property is displayed only when [Yes(List contents=specify)(-LISt)] in the [Output link map file] property and [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category are selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-SHow=Total_size)

Outputs the total sizes of sections separately for ROM-allocated sections and RAM-allocated sections.

No

Does not output the total size of sections.

(6)

[Message]

The detailed information on messages is displayed and the configuration can be changed.

Enable information message output

Select whether to enable the output of information messages.

This property corresponds to the -Message and -NOMessage options of the rlink command.

Default

No(-NOMessage)

How to change

Select from the drop-down list.

Restriction

Yes(-Message)

Outputs information messages.

No(-NOMessage)

Suppresses the output of information messages.

Suppress number of information message

Specify the number of the information message of which output is to be suppressed.

If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200).

Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300).

This property corresponds to the -NOMessage option of the rlink command.

This property is displayed when [No(-NOMessage)] in the [Enable information message output] property is selected.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 2048 characters

Change warning and error message to information message

Select whether to change the type of warning and error messages to information.

This property corresponds to the -CHange_message option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(All)(-CHange_message=Information)

Changes the type of all warning and error messages to information.

Yes(Specify message number)(-CHange_message=Information=<Message number>)

Specifies the number of warning and error message of which type is to be changed to information.

No

Does not change the type of warning and error messages.

Number of warning and error message

Specify the number of the warning and error message.

If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200).

Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300).

This property corresponds to the -CHange_message option of the rlink command.

This property is displayed only when [Yes(Specify message number)(-CHange_message=Information=<Message number>)] in the [Change warning and error message to information message] property is selected.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 2048 characters

Change information and error message to warning message

Select whether to change the type of information and error messages to warning.

This property corresponds to the -CHange_message option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(All)(-CHange_message=Warning)

Changes the type of all information and error messages to warning.

Yes(Specify message number)(-CHange_message=Warning=<Message number>)

Specifies the number of information and error message of which type is to be changed to warning.

No

Does not change the type of information and error messages.

Number of information and error message

Specify the number of the information and error message.

If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200).

Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300).

This property corresponds to the -CHange_message option of the rlink command.

This property is displayed only when [Yes(Specify message number)(-CHange_message=Warning=<Message number>)] in the [Change information and error message to warning message] property is selected.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 2048 characters

Change information and warning message to error message

Select whether to change the type of information and warning messages to error.

This property corresponds to the -CHange_message option of the rlink command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(All)(-CHange_message=Error)

Changes the type of all information and warning messages to error.

Yes(Specify message number)(-CHange_message=Error=<Message number>)

Specifies the number of information and warning message of which type is to be changed to error.

No

Does not change the type of information and warning messages.

Number of information and warning message

Specify the number of the information and warning message.

If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200).

Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300).

This property corresponds to the -CHange_message option of the rlink command.

This property is displayed only when [Yes(Specify message number)(-CHange_message=Error=<Message number>)] in the [Change warning message to information message] property is selected.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 2048 characters

(7)

[Others]

Other detailed information on creating a library is displayed and the configuration can be changed.

Reduce memory occupancy

Select whether to reduce the memory capacity.

This property corresponds to the -MEMory option of the rlink command.

This property is displayed only in the following cases.

-

When [No] in the [Delete local symbol name information] property in the [Debug Information] category is selected

-

When [User libraries(-FOrm=Library=U)] or [System libraries(-FOrm=Library=S)] in the [Output file format] property in the [Output File] category is selected

Default

No(-MEMory=High)

How to change

Select from the drop-down list.

Restriction

Yes(-MEMory=Low)

Reduces the memory capacity.

Select this item if processing is slow because a large project is linked and the memory size occupied by the linker exceeds the available memory in the machine used.

No(-MEMory=High)

Executes the same processing as usual.

Display total size of sections

Select whether to display the total size of sections after the linking.

This property corresponds to the -Total_size option of the rlink command.

This property is displayed only when [Relocatable file(-FOrm=Relocate)] in the [Output file format] property in the [Output File] category.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-Total_size)

Displays the total size of sections after the linking.

No

Does not display the total size of sections after the linki4ng.

Display copyright information

Select whether to display copyright information.

This property corresponds to the -LOgo and -NOLOgo options of the rlink command.

Default

No(-NOLOgo)

How to change

Select from the drop-down list.

Restriction

Yes(-LOgo)

Displays copyright information.

No(-NOLOgo)

Suppresses the output of copyright information.

Commands executed before create library processing

Specify the command to be executed before library generation processing.

Use the call instruction to specify a batch file (example: call a.bat).

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%LibraryFile%: Replaces with the absolute path of the output file under the library generation processing.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%Options%: Replaces with the command line option under build execution.

%OutputDir%: Replaces with the absolute path of the output folder.

%OutputFile%: Replaces with the absolute path of the output file.

%Program%: Replaces with the program name under execution.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

When "#!python" is described in the first line, the contents from the second line to the last line are regarded as the script of the Python console, and then executed before library generation processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

Default

Commands executed before library generate processing[number of defined items]

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 1023 characters

Up to 64 items can be specified.

Commands executed after create library processing

Specify the command to be executed after library generation processing.

Use the call instruction to specify a batch file (example: call a.bat).

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%LibraryFile%: Replaces with the absolute path of the output file under the library generation processing.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%Options%: Replaces with the command line option under build execution.

%OutputDir%: Replaces with the absolute path of the output folder.

%OutputFile%: Replaces with the absolute path of the output file.

%Program%: Replaces with the program name under execution.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

When "#!python" is described in the first line, the contents from the second line to the last line are regarded as the script of the Python console, and then executed after library generation processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

Default

Commands executed after library generate processing[number of defined items]

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 1023 characters

Up to 64 items can be specified.

Other additional options

Input the create library options to be added additionally.

The options set here are added at the end of the create library options group.

Default

Blank

How to change

Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 259 characters