S08 Linker > Input

Use this panel to specify the parameter file path, startup function, object file search paths, and any additional libraries that the C/C++ Linker should use. You can specify multiple additional libraries and library search paths. Also, you can change the order in which the IDE uses or searches the libraries.

The IDE first looks for an include file in the current directory, or the directory that you specify in the INCLUDE directive. If the IDE does not find the file, it continues searching the paths shown in this panel. The IDE keeps searching paths until it finds the #include file or finishes searching the last path at the bottom of the Include File Search Paths list. The IDE appends to each path the string that you specify in the INCLUDE directive.

Note: The IDE displays an error message if a header file is in a different directory from the referencing source file. Sometimes, the IDE also displays an error message if a header file is in the same directory as the referencing source file.

For example, if you see the message Could not open source file myfile.h, you must add the path for myfile.h to this panel.

The following table lists and describes the linker input options for HCS08.

Table 1. Tool Settings - Linker > Input Options
Option	Description
Parameter File	Shows the path of the parameter file. Default value is $ `{ProjDirPath}/Project_Settings/Linker_Files/Project.prm.`
Specify startup function (-E)	Defines the application entry point.
Search paths (-L)	Shows the list of all search paths; the ELF part of the linker searches object files first in all paths and then the usual environment variables are considered.
Libraries	Lists paths to additional libraries that the C/C++ linker uses. Default value is `"${MCUToolsBaseDir}/lib/hc08c/lib/ansiis.lib"`
Link case insensitive	With this option, the linker ignores object name capitalization. This option supports case-insensitive linking of assembly modules. Since all identifiers are linked case insensitive, this also affects C or C++ modules. This option only affects the comparison of names of linked objects. Section names or the parsing of the link parameter file are unaffected. They remain case sensitive.
Object File Format	Defines the object file format.

The following table lists and describes the toolbar buttons that help work with the libraries and the additional object file search paths.

Table 2. Search Paths Toolbar Buttons
Button	Description
	Add - Click to open the Add directory path dialog box and specify the object file search path.
	Delete - Click to delete the selected object file search path. To confirm deletion, click Yes in the Confirm Delete dialog box.
	Edit - Click to open the Edit directory path dialog box and update the selected object file search path.
	Move up - Click to move the selected object file search path one position higher in the list.
	Move down - Click to move the selected object file search path one position lower in the list.

The following figure shows the Add directory path dialog box.

Figure 1. Add directory path Dialog Box

The following figure shows the Edit directory path dialog box.

Figure 2. Edit directory path Dialog Box

The buttons in the Add directory path and Edit directory path dialog boxes help work with the object file search paths.

OK- Click to confirm the action and exit the dialog box.
Cancel- Click to cancel the action and exit the dialog box.
Workspace - Click to display the Folder Selection dialog box and specify the object file search path. The resulting path, relative to the workspace, appears in the appropriate list.
File system - Click to display the Browse for Folder dialog box and specify the object file search path. The resulting path appears in the appropriate list.

The following table lists and describes the toolbar buttons that help work with the libraries and the additional object files.

Table 3. Libraries Toolbar Buttons
Button	Description
	Add - Click to open the Add file path dialog box and specify location of the library you want to add.
	Delete - Click to delete the selected library path. To confirm deletion, click Yes in the Confirm Delete dialog box.
	Edit - Click to open the Edit file path dialog box and update the selected path.
	Move up - Click to move the selected path one position higher in the list.
	Move down - Click to move the selected path one position lower in the list.

The following figure shows the Add file path dialog box.

Figure 3. Tool Settings - Linker > Libraries - Add file path Dialog Box

The following figure shows the Edit file path dialog box.

Figure 4. Tool Settings - Linker > Libraries - Edit file path Dialog Box

The buttons in the Add file path and Edit file path dialog boxes help work with the file paths.

OK- Click to confirm the action and exit the dialog box.
Cancel- Click to cancel the action and exit the dialog box.
Workspace - Click to display the File Selection dialog box and specify the file path. The resulting path, relative to the workspace, appears in the appropriate list.
File system - Click to display the Open dialog box and specify the file path. The resulting absolute path appears in the appropriate list.