Input files can be combinations of host shared libraries, non-stripped target shared libraries, and non-stripped executable files. A file is compatible with another file if every library symbol in it that should be matched is matched in the second (that is, the symbol exists and has the same address in both files). The path name for the target shared library in both files must be identical (unless the -i option is set).
It is possible for file1 to be compatible with file2 without the reverse also being true.
If one incompatibility is found it is reported to standard output and processing stops (unless the -v option is set).
The options to chkshlib are:
The output of chkshlib depends on the input. If the first input file is an executable file and the other input files, if any, are target shared libraries, the output states whether or not the executable file can execute using each target shared library. If no target shared libraries are supplied, chkshlib does the compatibility check against the target shared libraries specified in the .lib section of the executable file.
If the first input file is an executable file and the other input file(s) is a host shared library, the output states whether or not the executable file could have been produced using each host.
If one input file is a host shared library and another is a target shared library, the output states whether or not the host shared library could produce executable files that will run with the target shared library. If no target shared library is supplied, chkshlib checks the compatibility against the target specified in the .lib section of the library definition file found in the host.
If both input files are target shared libraries or both are host shared libraries, the output states whether or not the first file could replace the second and vice versa.
If both input files are target libraries and the -n option is set, the output states whether the first file references symbols in the second file (``includes'' the second).
Compatibility of all other combinations of host shared libraries, target shared libraries, and executable files has no useful meaning, and these other combinations of files are not accepted as valid input to chkshlib.
The valid combinations of input files are:
All other forms of input are rejected.
Standard binaries distributed with the system are stripped, and chkshlib cannot be used with them.