libtool: Wrapper executables
1
1 3.3.1 Wrapper executables for uninstalled programs
1 --------------------------------------------------
1
1 Some platforms, notably those hosted on Windows such as Cygwin and
1 MinGW, use a wrapper executable rather than a wrapper script to ensure
1 proper operation of uninstalled programs linked by libtool against
1 uninstalled shared libraries. The wrapper executable thus performs the
1 same function as the wrapper script used on other platforms, but allows
1 to satisfy the 'make' rules for the program, whose name ends in
1 '$(EXEEXT)'. The actual program executable is created below .libs, and
1 its name will end in '$(EXEEXT)' and may or may not contain an 'lt-'
1 prefix. This wrapper executable sets various environment values so that
1 the program executable may locate its (uninstalled) shared libraries,
1 and then launches the program executable.
1
1 The wrapper executable provides a debug mode, enabled by passing the
1 command-line option '--lt-debug' (see below). When executing in debug
1 mode, diagnostic information will be printed to 'stderr' before the
1 program executable is launched.
1
1 Finally, the wrapper executable supports a number of command line
1 options that may be useful when debugging the operation of the wrapper
1 system. All of these options begin with '--lt-', and if present they
1 and their arguments will be removed from the argument list passed on to
1 the program executable. Therefore, the program executable may not
1 employ command line options that begin with '--lt-'. (In fact, the
1 wrapper executable will detect any command line options that begin with
1 '--lt-' and abort with an error message if the option is not
1 recognized). If this presents a problem, please contact the Libtool
1 team at the Libtool bug reporting address <bug-libtool@gnu.org>.
1
1 These command line options include:
1
1 '--lt-dump-script'
1 Causes the wrapper to print a copy of the wrapper _script_ to
1 'stdout', and exit.
1
1 '--lt-debug'
1 Causes the wrapper to print diagnostic information to 'stdout',
1 before launching the program executable.
1
1 For consistency, both the wrapper _script_ and the wrapper
1 _executable_ support these options.
1