Saltar al contenido principal

Control manual del sysroot de enlace (-C link-sysroot)

Este documento explica cómo controlar explícitamente el sysroot de la etapa de enlace en wavec.

Principios básicos:

  • --sysroot=<path>: sysroot de la etapa de compilación (clang -c)
  • -C link-sysroot=<path>: sysroot de la etapa de enlace (linker)

Es decir, separa el sysroot para la compilación y el enlace.

1. ¿Por qué es necesario?​

En el enlace cruzado, si se utiliza -C linker=<path>, a menudo es necesario especificar por separado las rutas de tiempo de ejecución (aarch64-linux-gnu-gcc, crt1.o, libc) a las que hace referencia el controlador de enlace (por ejemplo, libm).

En este caso, se diseña para que el sysroot de enlace no se infiera automáticamente, sino que se pase explícitamente en la CLI.

2. Definición de opción​

2.1 -C link-sysroot=<path>​

Inyecta --sysroot=<path> en la etapa de enlace.

wavec -C link-sysroot=/path/to/sysroot ...

Internamente, tiene el mismo significado que -C link-arg=--sysroot=<path>.

2.2 -C link-arg=--sysroot=<path>​

El método de argumento de enlace raw existente también es compatible.

wavec -C link-arg=--sysroot=/path/to/sysroot ...

3. Reglas de validación​

En una compilación que requiere la etapa de enlace, si se cumplen simultáneamente las siguientes condiciones, se termina con error de uso.

  1. Uso de -C linker=...
  2. Uso de --sysroot=<path>
  3. No se especifica el sysroot de enlace (-C link-sysroot o -C link-arg=--sysroot=...).

Ejemplo de mensaje de error:

when using -C linker=..., --sysroot=<path> is compile-stage only; pass linker sysroot explicitly with -C link-sysroot=<path> (or -C link-arg=--sysroot=<path>)

4. Ejemplo de uso​

4.1 Enlace cruzado para AArch64 Linux​

wavec \
  -C linker=aarch64-linux-gnu-gcc \
  --sysroot=/usr/aarch64-redhat-linux/sys-root/fc43 \
  -C link-sysroot=/usr/aarch64-redhat-linux/sys-root/fc43 \
  build test/test93.wave \
  --target aarch64-unknown-linux-gnu \
  --emit=bin \
  -o /tmp/test93-aarch64.bin

4.2 Método de argumento de enlace raw​

wavec \
  -C linker=aarch64-linux-gnu-gcc \
  --sysroot=/usr/aarch64-redhat-linux/sys-root/fc43 \
  -C link-arg=--sysroot=/usr/aarch64-redhat-linux/sys-root/fc43 \
  build test/test93.wave \
  --target aarch64-unknown-linux-gnu \
  --emit=bin

4.3 Compilación sin enlace (--emit=obj)​

Si no se requiere la etapa de enlace, no se necesita el sysroot de enlace.

wavec --sysroot=/path/to/sysroot build main.wave --emit=obj

5. Resumen​

  • --sysroot es control de la etapa de compilación
  • -C link-sysroot es control de la etapa de enlace
  • Prioridad al control explícito sobre la inferencia automática