vparreloc(1M) vparreloc(1M)
NAME
vparreloc - relocate the load address of a vmunix file, determine if a vmunix file is relocatable, or promote the scope of symbols in a
relocatable vmunix file
SYNOPSIS
target-load-address source-vmunix-file target-vmunix-file]
global-symbol-vmunix-file source-vmunix-file target-vmunix-file]
symbol-name source-vmunix-file target-vmunix-file]
source-vmunix-file
DESCRIPTION
There are four forms of this command. Each form requests that one of four supported operations be performed. The four forms are distin-
guished based on whether they contain a or none of these options.
If the fourth form of the command is used, then the source file is checked to determine if it is relocatable. The remaining three command
forms are described below.
The command is allowed on Itanium(R)-based platforms for compatibility. No action is taken for this command.
Options
recognizes the following command-line options:
Specifies that kernel relocation is requested.
The source file is relocated to the load address specified in the target load address option, and the result is written to the
target file. This option needs to be used when kernel relocation is required.
The file specified by this option is the source
file for the requested operation. The requested operation will be performed on this file, and the result will be placed into the
target file. This is a required option for all four forms of this command.
Specifies that global symbol promotion has been requested on a single symbol.
The symbol matching the symbol name specified is promoted to global scope, and the resulting file is written to the target file.
Note that only one option may be specified. All subsequent attempts to use this option will be ignored.
This option is useful when a very small number of symbols need to be promoted to global scope. There is no need to create a
global symbol file for this option.
Specifies that global symbol promotion has been requested.
All symbols in the source file which match a symbol with global scope in the global symbol file are promoted to have global
scope. The result is written to the target file.
The global symbol file can be created in one of two ways: it should either be a non-relocatable file, or a relocatable file which
has already been run through vparreloc using the option.
This option is useful when a tool expects certain symbols to be of global scope. The creation of a relocatable kernel file
changes the scope of all symbols in that file to be local.
Suppress the most common messages.
Note that error messages regarding an invalid file will still be printed. This option is only available with the fourth form of
this command.
This option is useful when used in a script which examines the return value of this command, and has no need for the informa-
tional messages.
The result of the requested operation will be placed into the target
file. The first three forms of this command utilize the target file option. If no target file option is specified, the default
becomes If the fourth form specifies a target file option, it will be ignored.
Note that the and options cannot be combined in a single invocation of the command.
EXAMPLES
To determine if a file is relocatable:
To relocate a file to be loaded at address 0x04000000, and place the resulting file into
To promote all symbols that should have global scope in a file that has been linked utilizing the kernel relocation options:
RETURN VALUE
The command exits with one of the following values:
Successful completion.
Bad options.
Can not open a file.
Error reading from or writing to a file, or allocating memory.
Invalid
kernel file.
File is not relocatable.
AUTHOR
was developed by the Hewlett-Packard Company.
SEE ALSO
vparextract(1M).
vparreloc(1M)