Detailed information for the notes.ini Keyword: 

Debug_TrapLeaks


Short Description: Used to troubleshooting memory leaks

Description:
While using trapleaks you can use a console command to show the allocated memory. It will show the allocated per-process memory and the allocated shared memory allocated in IBM® Lotus® Domino®.

This command is used to track potential memory leaks on demand without requiring the server to be shut down. Note that blocks reported by this command are not guaranteed to be leaks, but show what blocks of a given block type are allocated at any given time. To confirm possible leaks, the server will need to be shutdown to invoke trapleaks debug.

 
 
Answer
Common debug options:
DEBUG_TRAPLEAKS=<hex mem region>
DEBUG_TRAPLEAKS_SHOWSTACK=1
DEBUG_SHOW_MEMORY=1
DEBUG_SHOWLEAKS=1



Additionally, you can use a fourth argument to specify a cut-off period before which no information is dumped. This can be in two forms:
  • Number of minutes - indicates how many minutes back to dump trapleak information. Warning - you must specify the number of minutes with the character "<" before the number, and the character ">" after the number. Otherwise, the server will assume you are specifying a TIMEDATE value, which it will ignore if unrecognizable. Below is an example of the EXACT syntax you would use to capture trapleak data for the last 60 minutes:

"show mem alloc <60>"

  • TIMEDATE - indicates the time from which the server should dump trapleak information. You must use the time date format. For example, below is the syntax you would use to dump trapleak information from May 19th, 2006 at 3:30 PM to the present:

"show mem alloc 5/19/2006 15:30"


Note: If a fourth argument is not specified, this command will only dump trapleak information starting from 10 minutes after "server" begins (not the start time of a specific task). This means you will not see any trapleak data dumped if your server has not been up for at least 10 minutes, regardless of how many target blocks are currently allocated. If the server has been up fewer than 10 minutes, you must specify a fourth argument, as described above.


If you would like to set up a Program document to automate "show mem alloc", use the following settings:

Program name: nserver
Command line: -c "show mem alloc <60>"


Sample output. Notice the two bold lines with per-process and shared memory:

> show memory allocated
PER-PROCESS memory blocks allocated:

Allocated block: PID=0x7E0 Handle=0x000D Type=0x024B(PKG_0x2+75) Length=65412 Addr=24BFAF8
Contents: K..................| 4B02FEFFD2040000000D00000000000000F4007C
Allocated at 10/22/2004 23:30:17 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 60007036 nnotes! OSMemAllocExtended +390
Called from [03]: 600075BC nnotes! OSMemAlloc +28
Called from [04]: 60015763 nnotes! OSCreatePool +547
Called from [05]: 6001A4D4 nnotes! NSFNoteCreatePoolExtended +164
Called from [06]: 6001BACA nnotes! NoteOpenExtendedImpl +826
Called from [07]: 6001B744 nnotes! NoteOpenExtended +164
Called from [08]: 6001B68F nnotes! iNSFNoteOpenExtended +111
Called from [09]: 6001FE1D nnotes! NSFNoteOpenExtended +365
Called from [10]: 6003F776 nnotes! NSFNoteOpenExt +54
Called from [11]: 6069119E nnotes! Config::UpdateWhichParams +2974
Called from [12]: 60694421 nnotes! Config::UpdateParams +145
Called from [13]: 606BB3EE nnotes! ServerACLRefresh +142
Called from [14]: 10001DA9 nserverl! OneMinuteStuff +25
Called from [15]: 10001A69 nserverl! PollTask +377
Called from [16]: 100016CB nserverl! Scheduler +763
Called from [17]: 60115D84 nnotes! ThreadWrapper +212

Allocated block: PID=0x7E0 Handle=0x0012 Type=0x024B(PKG_0x2+75) Length=65412 Addr=3C762AC
Contents: K..................| 4B02FEFFD204000000120000000000000000007C
Allocated at 10/22/2004 23:30:17 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 60007036 nnotes! OSMemAllocExtended +390
Called from [03]: 600075BC nnotes! OSMemAlloc +28
Called from [04]: 60015763 nnotes! OSCreatePool +547
Called from [05]: 60015244 nnotes! NoteMemAlloc +612
Called from [06]: 60016296 nnotes! ItemAppendByBLOCKID +102
Called from [07]: 6001D639 nnotes! NoteOpenExtendedImpl +7849
Called from [08]: 6001B744 nnotes! NoteOpenExtended +164
Called from [09]: 6001B68F nnotes! iNSFNoteOpenExtended +111
Called from [10]: 6001FE1D nnotes! NSFNoteOpenExtended +365
Called from [11]: 6003F776 nnotes! NSFNoteOpenExt +54
Called from [12]: 6069119E nnotes! Config::UpdateWhichParams +2974
Called from [13]: 60694421 nnotes! Config::UpdateParams +145
Called from [14]: 606BB3EE nnotes! ServerACLRefresh +142
Called from [15]: 10001DA9 nserverl! OneMinuteStuff +25
Called from [16]: 10001A69 nserverl! PollTask +377
Called from [17]: 100016CB nserverl! Scheduler +763
Called from [18]: 60115D84 nnotes! ThreadWrapper +212

Allocated block: PID=0x7E0 Handle=0x0004 Type=0x024B(PKG_0x2+75) Length=65412 Addr=39D1530
Contents: K..................| 4B02FEFFD204000000040000000000000000007C
Allocated at 10/22/2004 23:30:17 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 60007036 nnotes! OSMemAllocExtended +390
Called from [03]: 600075BC nnotes! OSMemAlloc +28
Called from [04]: 60015763 nnotes! OSCreatePool +547
Called from [05]: 60015244 nnotes! NoteMemAlloc +612
Called from [06]: 6001D4E6 nnotes! NoteOpenExtendedImpl +7510
Called from [07]: 6001B744 nnotes! NoteOpenExtended +164
Called from [08]: 6001B68F nnotes! iNSFNoteOpenExtended +111
Called from [09]: 6001FE1D nnotes! NSFNoteOpenExtended +365
Called from [10]: 6003F776 nnotes! NSFNoteOpenExt +54
Called from [11]: 6069119E nnotes! Config::UpdateWhichParams +2974
Called from [12]: 60694421 nnotes! Config::UpdateParams +145
Called from [13]: 606BB3EE nnotes! ServerACLRefresh +142
Called from [14]: 10001DA9 nserverl! OneMinuteStuff +25
Called from [15]: 10001A69 nserverl! PollTask +377
Called from [16]: 100016CB nserverl! Scheduler +763
Called from [17]: 60115D84 nnotes! ThreadWrapper +212

Allocated block: PID=0x7E0 Handle=0x0009 Type=0x0A04(PKG_0xA+4) Length=65412 Addr=24AFB68
Contents: .................... 040AFEFF00000000000000000000000000000000
Allocated at 10/22/2004 23:18:46 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 60007036 nnotes! OSMemAllocExtended +390
Called from [03]: 600075BC nnotes! OSMemAlloc +28
Called from [04]: 60122EA2 nnotes! StartTransactionExtended +2290
Called from [05]: 60184501 nnotes! ClientDbOpenExtended2 +369
Called from [06]: 6002BF6A nnotes! NSFDbOpenExtended3 +9914
Called from [07]: 6007FE76 nnotes! NSFDbOpenExtended2 +54
Called from [08]: 6009C81A nnotes! NSFDbOpenExtended +58
Called from [09]: 606B7DD4 nnotes! GetSUDBFileNameFromNoteLink +52
Called from [10]: 606B6EC3 nnotes! SUGetPathCallbackOnServer +515
Called from [11]: 606B4A42 nnotes! EnumCompositeBufferWithIgnore +482
Called from [12]: 600A523A nnotes! EnumCompositeBuffer2 +26
Called from [13]: 606B484B nnotes! EnumCompositeBuffer +43
Called from [14]: 606B6FF4 nnotes! SUGetPath +164
Called from [15]: 606B6B6E nnotes! SUGetNearestKitsDB +158
Called from [16]: 606B6157 nnotes! NSFGetServerInfo +551
Called from [17]: 100323FF nserverl! SUGetLotusKitsDBReplicaIDFromServerNAB +31
Called from [18]: 100327D0 nserverl! SURefreshSmupdatePathName +64

Allocated block: PID=0x7E0 Handle=0x0016 Type=0x024B(PKG_0x2+75) Length=65412 Addr=39E14C0
Contents: K..................| 4B02FEFFD204000000160000000000000000007C
Allocated at 10/22/2004 23:30:17 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 60007036 nnotes! OSMemAllocExtended +390
Called from [03]: 600075BC nnotes! OSMemAlloc +28
Called from [04]: 60015763 nnotes! OSCreatePool +547
Called from [05]: 60015244 nnotes! NoteMemAlloc +612
Called from [06]: 60016296 nnotes! ItemAppendByBLOCKID +102
Called from [07]: 6001D639 nnotes! NoteOpenExtendedImpl +7849
Called from [08]: 6001B744 nnotes! NoteOpenExtended +164
Called from [09]: 6001B68F nnotes! iNSFNoteOpenExtended +111
Called from [10]: 6001FE1D nnotes! NSFNoteOpenExtended +365
Called from [11]: 6003F776 nnotes! NSFNoteOpenExt +54
Called from [12]: 6069119E nnotes! Config::UpdateWhichParams +2974
Called from [13]: 60694421 nnotes! Config::UpdateParams +145
Called from [14]: 606BB3EE nnotes! ServerACLRefresh +142
Called from [15]: 10001DA9 nserverl! OneMinuteStuff +25
Called from [16]: 10001A69 nserverl! PollTask +377
Called from [17]: 100016CB nserverl! Scheduler +763
Called from [18]: 60115D84 nnotes! ThreadWrapper +212

Allocated block: PID=0x7E0 Handle=0x0013 Type=0x024B(PKG_0x2+75) Length=3954 Addr=249FC64
Contents: K..................l 4B02FEFFD2040000001300000000000000F4006C
Allocated at 10/22/2004 23:31:10 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 60007036 nnotes! OSMemAllocExtended +390
Called from [03]: 600075BC nnotes! OSMemAlloc +28
Called from [04]: 60015763 nnotes! OSCreatePool +547
Called from [05]: 6001A4D4 nnotes! NSFNoteCreatePoolExtended +164
Called from [06]: 6001BACA nnotes! NoteOpenExtendedImpl +826
Called from [07]: 6001B744 nnotes! NoteOpenExtended +164
Called from [08]: 6001B68F nnotes! iNSFNoteOpenExtended +111
Called from [09]: 6001FE1D nnotes! NSFNoteOpenExtended +365
Called from [10]: 6003F776 nnotes! NSFNoteOpenExt +54
Called from [11]: 6006694D nnotes! OpenCollection +173
Called from [12]: 60066099 nnotes! NIFOpenCollectionExtended3 +2393
Called from [13]: 6006573C nnotes! NIFOpenCollectionExtended2 +60
Called from [14]: 60070FF4 nnotes! NIFOpenCollection +52
Called from [15]: 60083EC9 nnotes! FindDesignNote +329
Called from [16]: 60083D4D nnotes! NIFFindDesignNoteExt +93
Called from [17]: 6069078C nnotes! Config::UpdateWhichParams +396
Called from [18]: 60694421 nnotes! Config::UpdateParams +145

Allocated block: PID=0x7E0 Handle=0x000B Type=0x024B(PKG_0x2+75) Length=65412 Addr=3C6631C
Contents: K..................| 4B02FEFFD2040000000B0000000000000000007C
Allocated at 10/22/2004 23:30:17 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 60007036 nnotes! OSMemAllocExtended +390
Called from [03]: 600075BC nnotes! OSMemAlloc +28
Called from [04]: 60015763 nnotes! OSCreatePool +547
Called from [05]: 60015244 nnotes! NoteMemAlloc +612
Called from [06]: 6001D4E6 nnotes! NoteOpenExtendedImpl +7510
Called from [07]: 6001B744 nnotes! NoteOpenExtended +164
Called from [08]: 6001B68F nnotes! iNSFNoteOpenExtended +111
Called from [09]: 6001FE1D nnotes! NSFNoteOpenExtended +365
Called from [10]: 6003F776 nnotes! NSFNoteOpenExt +54
Called from [11]: 6069119E nnotes! Config::UpdateWhichParams +2974
Called from [12]: 60694421 nnotes! Config::UpdateParams +145
Called from [13]: 606BB3EE nnotes! ServerACLRefresh +142
Called from [14]: 10001DA9 nserverl! OneMinuteStuff +25
Called from [15]: 10001A69 nserverl! PollTask +377
Called from [16]: 100016CB nserverl! Scheduler +763
Called from [17]: 60115D84 nnotes! ThreadWrapper +212
Shared memory blocks allocated:

Allocated block: PID=0x7E0 Handle=0xF01C03DC Type=0x0A03(PKG_0xA+3) Length=8216 Addr=A051650
Allocated at 10/22/2004 22:43:26 by PID 0x7E0 - thread 0x40
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 600073F1 nnotes! OSMemoryAllocate +289
Called from [03]: 601132C3 nnotes! NetAllocBuffer +291
Called from [04]: 1001A624 nserverl! StartServer +852
Called from [05]: 1001A286 nserverl! DbServer +3542
Called from [06]: 10018341 nserverl! DbListen +2225
Called from [07]: 100016CB nserverl! Scheduler +763
Called from [08]: 60115D84 nnotes! ThreadWrapper +212

Allocated block: PID=0x7E0 Handle=0xF01C03DB Type=0x0A03(PKG_0xA+3) Length=8216 Addr=844906C
Allocated at 10/22/2004 23:18:46 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 600073F1 nnotes! OSMemoryAllocate +289
Called from [03]: 601132C3 nnotes! NetAllocBuffer +291
Called from [04]: 60122D4A nnotes! StartTransactionExtended +1946
Called from [05]: 60184501 nnotes! ClientDbOpenExtended2 +369
Called from [06]: 6002BF6A nnotes! NSFDbOpenExtended3 +9914
Called from [07]: 6007FE76 nnotes! NSFDbOpenExtended2 +54
Called from [08]: 6009C81A nnotes! NSFDbOpenExtended +58
Called from [09]: 606B7DD4 nnotes! GetSUDBFileNameFromNoteLink +52
Called from [10]: 606B6EC3 nnotes! SUGetPathCallbackOnServer +515
Called from [11]: 606B4A42 nnotes! EnumCompositeBufferWithIgnore +482
Called from [12]: 600A523A nnotes! EnumCompositeBuffer2 +26
Called from [13]: 606B484B nnotes! EnumCompositeBuffer +43
Called from [14]: 606B6FF4 nnotes! SUGetPath +164
Called from [15]: 606B6B6E nnotes! SUGetNearestKitsDB +158
Called from [16]: 606B6157 nnotes! NSFGetServerInfo +551
Called from [17]: 100323FF nserverl! SUGetLotusKitsDBReplicaIDFromServerNAB +31
Called from [18]: 100327D0 nserverl! SURefreshSmupdatePathName +64

Allocated block: PID=0x7E0 Handle=0xF01C03D4 Type=0x0A03(PKG_0xA+3) Length=8216 Addr=A053674
Allocated at 10/22/2004 22:43:26 by PID 0x7E0 - thread 0x40
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 600073F1 nnotes! OSMemoryAllocate +289
Called from [03]: 601132C3 nnotes! NetAllocBuffer +291
Called from [04]: 1001A624 nserverl! StartServer +852
Called from [05]: 1001A286 nserverl! DbServer +3542
Called from [06]: 10018341 nserverl! DbListen +2225
Called from [07]: 100016CB nserverl! Scheduler +763
Called from [08]: 60115D84 nnotes! ThreadWrapper +212

Allocated block: PID=0x7E0 Handle=0xF01C03BD Type=0x0A03(PKG_0xA+3) Length=8216 Addr=45D1280
Allocated at 10/22/2004 23:18:46 by PID 0x7E0 - thread 0x36
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 600073F1 nnotes! OSMemoryAllocate +289
Called from [03]: 601132C3 nnotes! NetAllocBuffer +291
Called from [04]: 60122D4A nnotes! StartTransactionExtended +1946
Called from [05]: 60184501 nnotes! ClientDbOpenExtended2 +369
Called from [06]: 6002BF6A nnotes! NSFDbOpenExtended3 +9914
Called from [07]: 6007FE76 nnotes! NSFDbOpenExtended2 +54
Called from [08]: 6009C81A nnotes! NSFDbOpenExtended +58
Called from [09]: 606B7DD4 nnotes! GetSUDBFileNameFromNoteLink +52
Called from [10]: 606B6EC3 nnotes! SUGetPathCallbackOnServer +515
Called from [11]: 606B4A42 nnotes! EnumCompositeBufferWithIgnore +482
Called from [12]: 600A523A nnotes! EnumCompositeBuffer2 +26
Called from [13]: 606B484B nnotes! EnumCompositeBuffer +43
Called from [14]: 606B6FF4 nnotes! SUGetPath +164
Called from [15]: 606B6B6E nnotes! SUGetNearestKitsDB +158
Called from [16]: 606B6157 nnotes! NSFGetServerInfo +551
Called from [17]: 100323FF nserverl! SUGetLotusKitsDBReplicaIDFromServerNAB +31
Called from [18]: 100327D0 nserverl! SURefreshSmupdatePathName +64

Allocated block: PID=0x7E0 Handle=0xF01C03B5 Type=0x0A03(PKG_0xA+3) Length=8216 Addr=A433118
Allocated at 10/22/2004 22:42:36 by PID 0x7E0 - thread 0x3F
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 600073F1 nnotes! OSMemoryAllocate +289
Called from [03]: 601132C3 nnotes! NetAllocBuffer +291
Called from [04]: 1001A624 nserverl! StartServer +852
Called from [05]: 1001A286 nserverl! DbServer +3542
Called from [06]: 10018341 nserverl! DbListen +2225
Called from [07]: 100016CB nserverl! Scheduler +763
Called from [08]: 60115D84 nnotes! ThreadWrapper +212

Allocated block: PID=0x7E0 Handle=0xF01C03AA Type=0x0A03(PKG_0xA+3) Length=8216 Addr=A4310F4
Allocated at 10/22/2004 22:42:36 by PID 0x7E0 - thread 0x3F
Called from [01]: 6019CA27 nnotes! OSAddBlockTraceBlock +55
Called from [02]: 600073F1 nnotes! OSMemoryAllocate +289
Called from [03]: 601132C3 nnotes! NetAllocBuffer +291
Called from [04]: 1001A624 nserverl! StartServer +852
Called from [05]: 1001A286 nserverl! DbServer +3542
Called from [06]: 10018341 nserverl! DbListen +2225
Called from [07]: 100016CB nserverl! Scheduler +763
Called from [08]: 60115D84 nnotes! ThreadWrapper +212
Memory Available (including virtual): 464.77734375 Mbytes
>





Default value:
None

Syntax:
Debug_TrapLeaks=hex mem region

Example:
Debug_TrapLeaks=01529

Applies to:
Server


Entry created by:
Bastian W.