relaytool(1) [debian man page]

RELAYTOOL(1)							 Listaller Project						      RELAYTOOL(1)

NAME

       relaytool - Generate a file that can be used instead of linking directly against a library

SYNOPSIS

       relaytool [OPTION ...] [LINKER COMMAND ...]

DESCRIPTION

       This manual page documents briefly the relaytool command.

       relaytool is a program to provide a more convenient interface to dlopen/dlsym. It lets you write the same style of code you would when
       using a normal hard link (-lwhatever), but the symbols are actually lazy-linked at runtime. You can use the symbols libwhatever_is_present
       and libwhatever_symbol_is_present() to find out what APIs are actually available at runtime.

       In other words, the need to use function pointers and lots of manual calls to dlsym() is eliminated, and it becomes much simpler to soft
       link to things as a result. If a symbol is missing at runtime and you call it anyway, your application will abort and an error message is
       printed that states which function was called. If a variable is missing at runtime, the value is always -1.

OPTIONS

       --relay LIB
	   If a matching -lLIB is found, generate a file that can be used instead of linking directly to LIB. The name of the file is echoed on
	   stdout. Multiple --relay can be used together, a file will be generated for each matching ones.

       --replace-all-libs
	   Generate a file for every -lLIB parameter.

       --minimal-list OBJ_LIST
	   Will look in OBJ_LIST for undefined symbols, and generate a file creating only the needed symbols for each LIB.

       --partial-map MAP_FILE
	   Generate a file creating only the symbols contained in MAP_FILE. Will apply to all further -lLIB parameters, so in general is not
	   suitable to multiple libs in the same invocation of relaytool.

       --no-replace
	   Echo -lLIB on stdout even if a --relay LIB is found, so it'll be linked in normally.

       --multilink [SONAMES...]
	   If a library has different SONAMES on different Linux distributions you can specify the various SONAMES that it's known by here.
	   Relaytool will attempt to load them (in the order provided) until one if found. This cannot be used with multiple --relay options. The
	   first SONAME in the list will be used as the name in the _is_present variable and _symbol_is_present function.

       --out-dir DIRECTORY
	   Write stub file to DIRECTORY instead of CWD.

LINKER COMMANDS

       -LPATH
	   Add PATH to the list of paths to search for LIBs.

       -lLIB
	   If a matching --relay LIB is found (or if --replace-all-libs is specified), generate a file that can be used instead of linking
	   directly to LIB. If there's no --relay LIB, echo -lLIB to stdout.

       All other linker commands are passed as is to stdout.

OTHER COMMANDS

       -h, --help
	   Show some help.

       --version
	   Display version information of relaytool

SEE ALSO

       lipkgen (1), ligcc(1), gcc(1).

       Additional documentation can be found on http://listaller.tenstral.net/wiki/doku.php/relaytool.

AUTHOR

       This manual page was written by Matthias Klumpp matthias@tenstral.net.

COPYRIGHT

       Copyright (C) 2009-2012 Matthias Klumpp

Listaller Project						    14 May,2012 						      RELAYTOOL(1)

Check Out this Related Man Page

METAXREF(1)                                                   General Commands Manual                                                  METAXREF(1)

NAME

       metaxref - builds cross-reference file/unit/item information

SYNOPSIS

       metaxref [ -dhkmsV ] [ -f manifest ] [ -L dir ]

DESCRIPTION

       Metaxref  is  a  program  that  scans all the files in your MANIFEST file and produces three files which contains information about how the
       files in that MANIFEST reference items defined by metaconfig's unit files.

       The first two files, I.fui and I.uif reference the file, unit and items sorted differently. The third file, Obsolete, dumps all  the  known
       obsolete symbols, in which file they appear and the new symbol that should be used instead.

       Note  that  obsolete  symbols do not appear in the main cross-reference files, but are only listed in the Obsolete file. That's yet another
       incentive to use the new symbols in your sources. :-)

OPTIONS

       Metaxref recognizes the following options:

       -d        Turn on debug mode.

       -f manifest
                 Use an alternate manifest file.

       -h        Print help message and exit.

       -k        Keep temporary .MT directory.

       -m        Assume lots of memory and swap space. This will drastically improve the symbol lookup time in your source files, at  the  expense
                 of memory usage.

       -s        Turn on silent mode.

       -L dir    Override default library location (where the U units directory can be found).

       -V        Print version number and exit.

AUTHOR

       Harlan Stenn <harlan@mumps.pfcs.com>

FILES

       LIB/dist/mcon/U/*.U
                 Public unit files.
       U/*.U     Private unit files
       I.fui     Lists information sorted by file, unit and item.
       I.uif     Lists information sorted by unit, item and file.
       Obsolete  Lists all the obsolete symbols used by the sources.

                      where LIB is /usr/share/dist.

BUGS

       Metaxref will list among the wanted items all those magic symbols defined within units on the ?M: lines. Those are relevant only when meta-
       config is invoked with the -M option.

SEE ALSO

       metaconfig(1), metalint(1)

                                                                  Version 3.5 PL0                                                      METAXREF(1)

Linux and UNIX Man Pages

relaytool(1) [debian man page]

Check Out this Related Man Page