chatr_pa.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

chatr_pa(1)

PA-RISC Systems Only

chatr_pa(1)

NAME

chatr_pa: chatr - change program’s internal attributes on PA-RISC systems

SYNOPSIS

PA-RISC 32-bit SOM chatr

chatr [-nqsMN [z|Z

]] [-l library ][-B mode][+b ﬂag][+dbg ﬂag][

+es ﬂag]

[

+mergeseg ﬂag][+gst

ﬂag][+gstbuckets size ][+gstsize size ][+k ﬂag][+l

library ]

[

+mem_check ﬂag][+pd size][

+pi size][+plabel_cache

ﬂag][+q3p ﬂag][+q4p ﬂag]

[

+r ﬂag][+rtc ﬂag][

+s ﬂag][+z ﬂag] ﬁle ...

PA-RISC 64-bit ELF chatr

There are two possible syntactic forms that can be used to invoke PA-RISC 64-bit

chatr.

FORMAT 1: The ﬁrst syntactic form, which is compatible with the SOM

chatr, is used for back-

ward compatibility, and for easy manipulation of ordinary ﬁles that only have a single text and a

single data segment:

chatr [-nqszZ][-l library ][

-B mode][+b ﬂag][+cd ﬂag][+ci

ﬂag][+es ﬂag][+gst ﬂag]

[

+gstsize size ][+k ﬂag][

+l library ][+md ﬂag][+mem_check ﬂag][+mi

ﬂag][+pd size]

[

+pi size][+rtc ﬂag][

+s ﬂag][+z ﬂag] ﬁle ...

FORMAT 2: The second syntactic form provides the ability to explicitly specify segments to be

modiﬁed:

chatr [-s][-B mode][+c ﬂag][+dz ﬂag][

+k ﬂag][+m ﬂag][+p size][+r ﬂag][+s ﬂag]

[

+si index | +sa address | +sall ][+z ﬂag] ﬁle ...

Remarks

This manpage describes

chatr on PA-RISC systems. For chatr

on Integrity systems, see chatr_ia (1).

DESCRIPTION

chatr allows you to change a program’s internal attributes for 32-bit mode SOM and 64-bit mode ELF

ﬁles.

Upon completion,

chatr prints the ﬁle’s old and new values to standard output unless

-s is speciﬁed.

The

+pd and +pi options only provide a hint for the virtual memory page size. The actual page sizes

may vary. Under certain conditions, page size hints of L may result in better performance, depending on

the speciﬁc memory requirements of the application.

The performance of some applications may beneﬁt from static branch prediction, others may not. The

option provides a hint for using or avoiding this feature.

The

+gst and related options provide performance enhancements through use of global symbol table

which improves searching for exported symbols. See dld.sl (5) and the HP-UX Linker and Libraries

Online User Guide for more information.

Common Options For PA-RISC 32-bit SOM And PA-RISC 64-bit ELF (FORMAT 1) chatr

chatr, by default, prints each ﬁle’s magic number and ﬁle attributes to the standard output.

-l library Indicate that the speciﬁed shared library is subject to run-time path lookup if directory

path lists are provided (see +s and +b).

-n Change ﬁle from demand-loaded (DEMAND_MAGIC) to shared (SHARE_MAGIC)(Ignored

in PA-RISC 64-bit FORMAT 1.)

-q Change ﬁle from shared (SHARE_MAGIC) to demand-loaded (DEMAND_MAGIC).

(Ignored in PA-RISC 64-bit FORMAT 1.)

-s Perform its operation silently. (Available with the PA-RISC 64-bit FORMAT 2 com-

mand.)

-B mode Select run-time binding behavior mode of a program using shared libraries. You must

specify one of the major binding modes immediate or deferred. One or more of the

binding modiﬁers nonfatal, verbose,or restricted can also be speciﬁed, each

with a separate option. See the HP-UX Linker and Libraries User’s Guide manual for a

description of binding modes. (Available with the PA-RISC 64-bit FORMAT 2 command.)

+b flag Control whether the embedded path list stored when the program (if any) was built can

be used to locate shared libraries needed by the program. The two ﬂag values, enable

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
chatr_pa(1) chatr_pa(1) PA-RISC Systems Only NAME chatr_pa: chatr - change program’s internal attributes on PA-RISC systems SYNOPSIS PA-RISC 32-bit SOM chatr chatr [-nqsMN [z|Z] ] [-l library ] [-B mode] [+b flag] [+dbg flag] [+es flag] [+mergeseg flag] [+gst flag] [+gstbuckets size ] [+gstsize size ] [+k flag] [+l library ] [+mem_check flag] [+pd size ] [+pi size ] [+plabel_cache flag] [+q3p flag] [+q4p flag] [+r flag] [+rtc flag] [+s flag] [+z flag] file ...
PAGE 2
chatr_pa(1) chatr_pa(1) PA-RISC Systems Only and disable, respectively enable and disable use of the embedded path list. However, you cannot use disable on an ELF (PA-RISC 64-bit) file and a warning message is issued. See the +s option. You can use the +b option to enable the embedded path for filter libraries. +dbg flag A Controls the mapping of shared library text segments privately. The flag values, enable and disable, toggle the request on and off.
PAGE 3
chatr_pa(1) PA-RISC Systems Only chatr_pa(1) RISC 64-bit FORMAT 2 command.) +z Enable lazy swap on all data segments (using PA-RISC 32-bit chatr or PA-RISC 64-bit chatr FORMAT 1) or on a specific segment (using PA-RISC 64-bit ELF chatr FORMAT 2). May not be used with non-data segments. -z Enable null pointer dereference trap. Run-time dereference of null pointers will produce a SIGSEGV signal. (This is the complement of the -Z option.) -Z Disable null pointer dereference trap.
PAGE 4
chatr_pa(1) chatr_pa(1) PA-RISC Systems Only Options For PA-RISC 64-bit ELF chatr PA-RISC 64-bit ELF chatr is similar to SOM chatr but supports new options (and obsoletes others). New options: OPTIONS FOR PA-RISC 64-bit ELF chatr (FORMAT 1) +cd Set the code bit for the file’s data segment(s). +ci Set the code bit for the file’s text segments(s). +md Set the modification bit for the file’s data segment(s). +mi Set the modification bit for the file’s text segment(s).
PAGE 5
chatr_pa(1) PA-RISC Systems Only chatr_pa(1) mapped files using a shared mapping (MAP_SHARED). In order to use this new feature, the maxdsiz kernel configurable variable will need to be increased appropriately; see maxdsiz (5). Also, the system will have to enable enough swap space to support processes with large private address spaces. Compatibility issues Processes that enable a private 3rd quadrant (q3p processes) will reduce the amount of address space available for shared objects by 1GB.
PAGE 6
chatr_pa(1) chatr_pa(1) PA-RISC Systems Only minimize the need for manual intervention by whomever installs the program. An alternate method is setting the kernel tunable parameter, executable_stack, to set a systemwide default for whether stacks are executable. Setting the executable_stack parameter to 1 (one) with sam (see sam(1M)) tells the HP-UX kernel not to execute protect program stack(s). This is the preferred setting if compatibility with older releases is more important than security.
PAGE 7
chatr_pa(1) chatr_pa(1) PA-RISC Systems Only Invalid arguments If you use an invalid argument with a valid option and you do not specify a file name, both PA-RISC 32bit and 64-bit chatr return 0. chatr +b returns 0. For PA-RISC 32-bit chatr, if you specify a file name (regardless of whether or not the file exists), chatr returns number of words in the command line. chatr +b file returns 4.
PAGE 8
chatr_pa(1) chatr_pa(1) PA-RISC Systems Only AUTHOR chatr was developed by HP. SEE ALSO System Tools ld(1) Miscellaneous a.