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 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 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 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.
- system error. One possible cause is that has not yet been initialized on the local computer; run ionadmin(1) to correct this.
- Can't start trace.
- Insufficient working memory to contain trace information. Reinitialize with more memory.