NAME
modstrmax — allocates the size of the kernel dumpstrtab string table
VALUES
Allowed Values
0 or any positive integer.
DESCRIPTION
modstrmax
is used to allocate the size of the kernel
dumpstrtab
string table.
This table will contain packed, null-terminated character strings,
and is used to hold string information containing the paths and
module names of the Dynamically Loadable Kernel Modules (DLKM) that are
loaded.
If the kernel contains no DLKM modules, the table will contain the
booted kernel name and path for the statically linked kernel.
This information is used by dump and savecrash to supply Q4 proper information
for debugging purposes.
Who is Expected to Change This Tunable?
Anyone.
Is this Tunable Static, Dynamic or Automatic?
This tunable is static.
When Should the Value of This Tunable Be Raised?
This tunable should be raised when the string lengths of the full pathnames
to all loaded DLKM modules, plus the string lengths of the module names
for all loaded DLKM modules, plus the string terminators would exceed the value
found in the tunable.
What Are the Side Effects of Raising the Value?
Increases the size of the
dumpstrtab
array.
When Should the Value of This Tunable Be Lowered?
If there are no DLKM modules, the information for the static kernel is
stored in the associated tables.
The value could be reduced to the size of the booted kernel path,
plus the booted kernel name, plus the end of string terminators, but
there is no huge gain in doing this.
What Are the Side Effects of Lowering the Value?
If there is not enough space to store the module name
and path name in the
dumpstrtab,
then a warning is issued and the information about the loaded
module will not be available to dump, savecrash and Q4 for debugging.
What Other Tunable Values Should Be Changed at the Same Time?
initmodmax
allocates the size of the
dumpstrindex
and
dumpmodtab
arrays.
The
dumpmodtab
is an array of
dumpmodule_t
structures that contain data for all DLKM modules that have been loaded.
The data structure is used by the dump and savecrash mechanism
to communicate sufficient information to Q4 to allow proper
debuggging of a core image.
The
dumpstrindex
array contains indexes (instead of character pointers) into the
dumpstrtab
string table for the module name and pathname.
If the number of modules increases, then the
modstrmax
should be increased also.
WARNINGS
All HP-UX kernel tunable parameters are release specific.
This parameter may be removed or have its meaning changed in
future releases of HP-UX.
AUTHOR
modstrmax
was developed by HP.
Printable version
