You copied the Doc URL to your clipboard.

--sysroot=path

GCC and GNU ld are configured against a common sysroot. This means that where ld scripts refer to their subordinate libraries using an absolute path, the path is still relative to sysroot.

This option enables armlink to treat any absolute paths found from library scripts to be treated as relative to the specified path.

Because implicit ld scripts are going to be enabled only in --sysv mode, this only takes effect when targeting ARM Linux. Relative paths must still search the normal userlibpath list for the file.

This option affects the following ld script commands:

  • INPUT

  • GROUP

  • SEARCH_DIR.

If sysroot is not NULL:

  • Any absolute paths in INPUT, GROUP or SEARCH_DIR commands have sysroot prepended.

  • Any paths beginning with the = character have that character replaced by sysroot, but only for SEARCH_PATH commands.

    Note

    The linker removes the = character if no sysroot is configured.

Syntax

--sysroot=path

where path is location that is to be treated as the common sysroot.

Previous Next
Was this page helpful? Yes No