HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

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.
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 global
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 vpar-
reloc 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.
Note that the -a, -G, and -g options cannot be combined in a single invocation of the command.
Section 1M−−1110 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005