__declspec(section name)

Specifies where to store a variable or function in a section that has been predefined or defined with the #pragma section directive.

__declspec(section <section_name>) declaration
  

__declspec(section <section_name>) definition
  

section_name

Specifies the name of an initialized data section.

• When you specify an uninitialized section name while declaring or defining a function or variable with this declaration specification, the compiler generates an error.

  For example, if you use __declspec (section ".bss") extern int my_var;, where .bss is an uninitialized section you will get a descriptive error. In this case, use __declspec (section ".data") extern int my_var; as .data is normally paired with .bss and .data is an initialized section. Assuming the variable you are attaching this __declspec to is an uninitialized object (which is the case with my_var), the object will go into .bss.

• When you use __declspec on the definition, __declspec on a declaration is ignored. The listing below shows an example of __declspec used to put data and code objects into specific sections.
  Figure 1. Example of a declaration specification

__declspec (section ".init") extern void cache_init1(void);
__declspec (section ".text") extern void cache_init2(void); 
extern void cache_init3(void);

void cache_init1(){} // goes into .init if the prototype is visible for 
this definition 

__declspec (section ".init") void cache_init2(){} // ignores previous 
section .text and goes into .init 

__declspec (section ".init") void cache_init3(){} // by default the 
declaration  implies .text but the definition forces it to .init

The predefined sections set with an object type become the default section for that type. The compiler predefines the sections listed in the table below.