Content-type: text/html Man page of fixso

fixso

Section: User Commands (1)
Index Return to Main Contents
 

NAME

fixso - Fixes a shared object so that it can be quickstarted  

SYNOPSIS

fixso [+i|-i] [+w|-w] [+d|-d] [+n|-n] [-o outputobj] [-p path] inputobj


 

OPTIONS

Turns informational message reporting on and off, respectively. By default, informational messages are not reported. Turns warning message reporting on and off, respectively. By default, warning messages are reported. Turns debugging message reporting on and off, respectively. By default, debugging messages are not reported. Turns output generation on and off, respectively. By default, fixso writes output to a.out or to the file specified by the -o option. If you specify -n, fixso just analyzes the inputobj and generates no output. Specifies the file to which fixso writes its output. By default, output is sent to a.out. Adds path to the beginning of the shared library search path. The default library search path, as explained in loader(5), is used. The fixso utility also honors any definition of the LD_LIBRARY_PATH environment variable.
 

DESCRIPTION

The fixso utility allows executables that depend on a shared library registered in the so_locations database to continue to run quickstarted even if the shared library changed after the time the executable was originally linked against it. The fixso utility accomplishes this by adjusting the object's checksum and timestamp, reconciling the object's conflict table (the list of symbols that are multiply defined among the entries in the object's library list), and resolving global symbols.

You specify one executable or shared object in the inputobj parameter. The fixso utility opens the target object, scanning its library list for dependencies on symbols defined in other objects. When it discovers a dependency, it automatically opens the associated object and continues processing it in the same manner, as long as it is located in the default library search path, the path indicated by the LD_LIBRARY_PATH environment variable, or specified by the -p option. Otherwise, it generates a message, requiring you to run fixso on that object first.

The fixso utility examines each object's interface version, shared object name (soname), timestamp, and checksum. Although it can adjust timestamp and checksum discrepancies among the entries in the object's library list, fixso has the following restrictions: The fixso utility does not change the size of the binary object; it will not expand the size of the conflict table if it encounters a new multiply-defined symbol while traversing the object's library list. An object's actual run-time memory location must match the quickstart location recorded in the so_locations file. The fixso utility cannot make an object quick-startable if the object has been moved from its quickstart location, or if another object has been moved into its quickstart location. The version of the run-time linker interface used by an object mapped in the inputobj's library list must be the same version used when inputobj was created by the linker. An object mapped in inputobj's library list must be located in the same library search path it was in when inputobj was created by the linker. The soname of an object mapped in inputobj's library list must be the same as when inputobj was created by the linker. By default, an object's soname is its filename (without a prepended pathname).
 

ERRORS

The fixso utility generates the following categories of message: Error messages that indicate when the current use of the tool violates one of its restrictions, as described above. Error messages also help you determine the correct order in which to run fixso on a series of objects. You cannot turn off error messages. Warning messages that indicate conflicts, such as timestamp and checksum mismatches, that fixso attempts to fix automatically. The fixso utility generates warning messages by default. You can turn them off by specifying the -w option. Informational and debug messages that record the fixso utility's progress. These messages are off by default, but you can turn them on by using the +i and +d options, respectively.
 

FILES

Shared library directory. Shared library directory. Shared library directory. Shared library directory. Shared library directory. Fix quickstarted shared objects utility.
 

SEE ALSO

ld(1), loader(5)

Programmer's Guide


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
ERRORS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:59 GMT, October 02, 2010