/SECTION (Especificar atributos de sección)

  • Artículo

/SECTION:name,[[!]{D|E|K|P|R|S|W}][,ALIGN=number]

Comentarios

La opción /SECTION cambia los atributos de una sección, reemplazando los atributos establecidos cuando se compiló el archivo .obj de la sección.

Una sección de un archivo ejecutable portátil (PE) es un bloque contiguo de memoria que contiene código o datos. Algunas secciones contienen código o datos que el programa declaró y usa directamente. El enlazador y el administrador de bibliotecas (LIB) crean otras secciones de datos y contienen información vital para el sistema operativo. Para obtener más información, vea Formato PE.

Especifique dos puntos (:) y un nombre de secciónname. name distingue mayúsculas de minúsculas.

No use los siguientes nombres, ya que entran en conflicto con los nombres estándar. Por ejemplo, .sdata se usa en plataformas RISC:

  • .arch

  • .bss

  • .data

  • .edata

  • .idata

  • .pdata

  • .rdata

  • .reloc

  • .rsrc

  • .sbss

  • .sdata

  • .srdata

  • .text

  • .xdata

Especifique uno o varios atributos para la sección. Los caracteres de atributo que se enumeran a continuación no distinguen mayúsculas de minúsculas. Debe especificar todos los atributos que desea que tenga la sección. Un carácter de atributo omitido hace que el bit de atributo se desactive. Si no especifica R, Wo E, el estado existente de lectura, escritura o ejecutable permanece sin cambios.

Para negar un atributo, precede a su carácter con un signo de exclamación (!). Los significados de los caracteres de atributo se muestran en esta tabla:

Carácter Atributo Significado
E Ejecutar La sección es ejecutable
R Lectura Permite operaciones de lectura en los datos.
W Escritura Permite operaciones de escritura en los datos.
S Compartido Comparte la sección entre todos los procesos que cargan la imagen.
D Descartable Marca la sección como descartable.
K Almacenable en caché Marca la sección como no almacenable en caché.
P Paginable Marca la sección como no paginable.

K y P son inusuales en que las marcas de sección que corresponden a ellas se usan en el sentido negativo. Si especifica una de ellas en la sección .text mediante la opción /SECTION:.text,K, no hay ninguna diferencia en las marcas de sección al ejecutar DUMPBIN con la opción /HEADERS; la sección ya estaba almacenada en caché implícitamente. Para quitar el valor predeterminado, especifique /SECTION:.text,!K en su lugar. DUMPBIN revela las características de sección, incluidas "No almacenadas en caché".

Es probable que una sección del archivo PE que no tenga E, R o W establecida no sea válida.

El argumento ALIGN=number permite especificar un valor de alineación para una sección determinada. El argumento number está en bytes y debe ser una potencia de dos. Para obtener más información, vea /ALIGN.

Para establecer esta opción del vinculador en el entorno de desarrollo de Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento de las propiedades del compilador y la compilación.

  2. Elija la página de propiedades del enlazador>general de propiedades>de configuración.

  3. Modifique la propiedad Especificar atributos de sección. Haga clic en Aceptar o en Aplicar para guardar los cambios.

Para establecer esta opción del vinculador mediante programación

Consulte también

Referencia del enlazador MSVC
Opciones del enlazador MSVC