NAME¶
psmwatch - PSM memory partition activity monitor
SYNOPSIS¶
psmwatch shared_memory_key memory_size
partition_name interval count [ verbose ]
DESCRIPTION¶
For
count interations,
psmwatch sleeps
interval seconds and
then invokes the
psm_print_trace() function (see
psm(3)) to
report on PSM dynamic memory management activity in the PSM-managed shared
memory partition identified by
shared_memory_key during that interval.
If the optional
verbose parameter is specified, the printed PSM
activity trace will be verbose as described in
psm(3).
To prevent confusion, the specified
memory_size and
partition_name
are compared to those declared when this shared memory partition was initially
managed; if they don't match,
psmwatch immediately terminates.
If
interval is zero,
psmwatch merely prints a current usage
summary for the indicated shared-memory partition and terminates.
psmwatch is helpful for detecting and diagnosing memory leaks. For
debugging the ION protocol stack:
- shared_memory_key
- Normally "65281", but might be overridden by the value of wmKey
in the .ionconfig file used to configure the node under study.
- memory_size
- As given by the value of wmKey in the .ionconfig file used to configure
the node under study. If this value is not stated in the .ionconfig file,
the default value is "5000000".
- partition_name
- Always "ionwm".
EXIT STATUS¶
- "0"
- psmwatch has terminated.
FILES¶
No configuration files are needed.
ENVIRONMENT¶
No environment variables apply.
DIAGNOSTICS¶
The following diagnostics may be issued to the
ion.log log file:
- Can't attach to psm.
- ION system error. One possible cause is that ION has not yet been
initialized on the local computer; run ionadmin(1) to correct
this.
- Can't start trace.
- Insufficient ION working memory to contain trace information. Reinitialize
ION with more memory.
BUGS¶
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO¶
psm(3),
sdrwatch(1)