define_section

Specifies a predefined section or defines a new section for compiled object code.

#pragma define_section sname ".istr" [.ustr] [.rostr][addrmode] [accmode]

Parameters

sname

Identifier for source references to this user-defined section. Make sure this name does not conflict with names recognized by the __declspec directive.

istr

Section-name string for initialized data assigned to this section. Double quotes must surround this parameter value, which must begin with a period. (Also applies to uninitialized data if there is no ustr value.)

ustr

Optional, if there is no initialized data: ELF section name for uninitialized data assigned to this section. Must begin with a period. Default value is the istr value.

rostr

Optional, if there is no initialized data: ELF section name for read only data assigned to this section. Must begin with a period. Default value is the istr value.

Note: Follow the order if either ustr or rostr is specified. And each of istr, ustr, rostr should have unique name.

addrmode

Optional: optional parameter indicates how the linker addresses the section. You set this parameter to one of the following values:

- abs32 - 32-bit absolute addressing mode. Use for applications where all memory addresses are known at link time (default).
- far_abs - 32-bit addressing mode where addressed function object may be out of direct branch range. Generates an indirect call to a function.
For more information, refer the far_call for ARM chapter in this manual.
- pcrel32 - 32-bit PC-relative mode for position-independent code (PIC) sections.
- sbrel32 - 32-bit static base register(SB)-relative mode for position-indepenent data (PID) sections.
- sbrel12 - 12-bit static base register-relative mode for small data sections (.sdata). Sections addressed via this mode must be placed within 4Kb of the address pointed to by the SB register. These small data sections let the compiler generate more efficient sequences for loading and storing global variables.

acc

Optional: any of these letter combinations:

R - readable
RW - readable and writable
RX - readable and executable
RWX - readable, writable, and executable (default)

(No other letter orders are valid: WR, XR, or XRW would be an error.)

Remarks

The compiler predefines the common Kinetis sections that The following table lists.

Table 1. ARM Predefined Sections
Applicability	Definition Pragmas
ARM Predefined Sections	#pragma define_section text,".text",abs32,RX
	#pragma define_section data,".data",".bss",abs32,RW
	#pragma define_section strdata,".data",".bss",abs32,RW
	#pragma define_section npdata,".data",".bss",abs32,RW
	#pragma define_section sdata,".sdata",abs32,RW
	#pragma define_section rodata,".rodata",abs32,R
	#pragma define_section strrodata,".rodata",abs32,R
	#pragma define_section nprodata,".rodata",abs32,R
	#pragma define_section pinit,".init_table",abs32,RW
	#pragma define_section init,".init",abs32,RX
	#pragma define_section picdynrel,".picdynrel",pcrel32,R
	#pragma define_section piddynrel,".piddynrel",sbrel32,R