vparreloc.1m (2010 09)

v
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
vparreloc -a target-load-address
-f source-vmunix-file [
-t target-vmunix-file ]
vparreloc -G global-symbol-vmunix-file
-f source-vmunix-file [
-t target-vmunix-file ]
vparreloc -g symbol-name -f source-vmunix-file [
-t target-vmunix-file ]
vparreloc -f source-vmunix-file [
-q]
DESCRIPTION
There are four forms of this command. Each form requests that one of four supported operations be per-
formed. The four forms are distinguished based on whether they contain a
-a
, -G, -g 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
vparreloc command is allowed on Itanium-based platforms for compatibility. No action is taken
for this command.
Options
vparreloc recognizes the following command-line options:
-a target-load-address
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
vmunix file.
This option needs to be used when kernel relocation is required.
-f source-vmunix-file
The file specified by this option is the source vmunix file for the requested operation. The
requested operation will be performed on this file, and the result will be placed into the target
vmunix file. This is a required option for all four forms of this command.
-g symbol-name
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 vmunix file
is written to the target
vmunix file. Note that only one -g symbol-name 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
vmunix file for this option.
-G global-symbol-vmunix-file
Specifies that global symbol promotion has been requested. All symbols in the source vmunix
file which match a symbol with global scope in the global symbol file are promoted to have glo-
bal scope. The result is written to the target vmunix file.
The global symbol
vmunix file can be created in one of two ways: it should either be a non-
relocatable vmunix file, or a relocatable vmunix file which has already been run through
vparreloc using the -G 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.
-q Suppress the most common messages. Note that error messages regarding an invalid vmunix
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 informational messages.
-t target-vmunix-file
The result of the requested operation will be placed into the target vmunix file. The first
three forms of this command utilize the target vmunix file option. If no target vmunix file
option is specified, the default becomes vmunix.out. If the fourth form specifies a target
vmunix file option, it will be ignored.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1