section pragma

Creates a section in an OBJ file.

Syntax

#pragma section( " section-name " [ , attributes ] )

Remarks

The terms segment and section have the same meaning in this article.

Once a section is defined, it remains valid for the rest of the compilation. However, you must use __declspec(allocate), or nothing is placed in the section.

section-name is a required parameter that becomes the name of the section. The name must not conflict with any standard section names. See /SECTION for a list of names you shouldn't use when creating a section.

attributes is an optional parameter consisting of one or more comma-separated attributes to assign to the section. Possible attributes are:

Attribute Description
read Allows read operations on data.
write Allows write operations on data.
execute Allows code to be executed.
shared Shares the section among all processes that load the image.
nopage Marks the section as not pageable. Useful for Win32 device drivers.
nocache Marks the section as not cacheable. Useful for Win32 device drivers.
discard Marks the section as discardable. Useful for Win32 device drivers.
remove Marks the section as not memory-resident. For virtual device drivers (VxD) only.

If you don't specify any attributes, the section has read and write attributes.

Example

In this example, the first section pragma identifies the section and its attributes. The integer j isn't put into mysec because it wasn't declared using __declspec(allocate). Instead, j goes into the data section. The integer i does go into mysec because of its __declspec(allocate) storage-class attribute.

// pragma_section.cpp
#pragma section("mysec",read,write)
int j = 0;

__declspec(allocate("mysec"))
int i = 0;

int main(){}

See also

Pragma directives and the __pragma and _Pragma keywords