define_section

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

#pragma define_section sname ".istr" [.ustr] [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: ELF section name for uninitialized data assigned to this section. Must begin with a period. Default value is the istr value.

addrmode

Optional: any of these address-mode values:

standard - 32-bit absolute address (default)
near_absolute - 16-bit absolute address
far_absolute - 32-bit absolute address
near_code - 16-bit offset from the PC address
far_code - 32-bit offset from the PC address
near_data - 16-bit offset from the A5 register address
far_data - 32-bit offset from the A5 register address

accmode

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 PowerPC sections that the following table lists.

Table 1. ColdFire Predefined Sections
Applicability	Definition Pragmas
Absolute Addressing Mode	`#pragma define_section text ".text" far_absolute RX`
	`#pragma define_section data ".data" ".bss" far_absolute RW`
	`#pragma define_section sdata ".sdata" ".sbss" near_data RW`
	`#pragma define_section const ".rodata" far_absolute R`
C++, Regardless of Addressing Mode	`#pragma define_section exception ".exception" far_absolute R`
C++, Regardless of Addressing Mode	`#pragma define_section exceptlist ".exceptlist" far_absolute R`
PID Addressing Mode	`#pragma define_section text ".text" far_absolute RX`
	`#pragma define_section data ".data" ".bss" far_data RW`
	`#pragma define_section sdata ".sdata" ".sbss" near_data RW`
	`#pragma define_section const ".rodata" far_absolute R`
PIC Addressing Mode	`#pragma define_section text ".text" far_code RX`
	`#pragma define_section data ".data" ".bss" far_absolute RW`
	`#pragma define_section sdata ".sdata" ".sbss" near_data RW`
	`#pragma define_section const ".rodata" far_code R`

Another use for #pragma define_section is redefining the attributes of predefined sections:

To force 16-bit absolute addressing for all data, use
```
#pragma define_section data ".data" near_absolute
```

To force 32-bit absolute addressing for exception tables, use:

#pragma define_section exceptlist ".exceptlist" far_code

#pragma define_section exception ".exception" far_code

You should put any such attribute-redefinition pragmas, in a prefix file or other header that your program's all source files will include.

Note: The ELF linker's Section Mappings settings panel must map any user-defined compiler section to an appropriate segment.