Cisco ASR 14000 Series Management Command Reference page 516

follow
C i s c o C o n f i d e n t i a l - B e t a R e v i e w R 3 . 7. 1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper
task IDs.
Use this command to unintrusively debug a live process or a live thread in a process. This command is
particularly useful for debugging deadlock and livelock conditions, for examining the contents of a
memory location or a variable in a process to determine the cause of a corruption issue, or in
investigating issues where a thread is stuck spinning in a loop. A livelock condition is one that occurs
when two or more processes continually change their state in response to changes in the other processes.
The following actions can be specified with this command:
•
•
•
•
•
•
Take a snapshot of the execution path of a thread asynchronously to investigate performance-related
issues by specifying a high number of iterations with a zero delay.
Task ID Task ID
basic-services
Examples The following example shows how to use the follow command to debug the process associated with job
ID 257 for one iteration:
RP/0/RP0/CPU0:router# follow job 257 iteration 1
Attaching to process pid = 28703 (pkg/bin/packet)
No tid specified, following all threads
DLL Loaded by this process
-------------------------------
DLL path
/pkg/lib/libovl.dll
/pkg/lib/libplatform.dll 0xfc0d6000 0x0000aa88 0xfc0e1000 0x00002000
/pkg/lib/libsysmgr.dll
/pkg/lib/libinfra.dll
/pkg/lib/libios.dll
/pkg/lib/libc.dll
/pkg/lib/libsyslog.dll
/pkg/lib/libbackplane.dll 0xfc1da000 0x0000134c 0xfc0c3e6c 0x000000a8
/pkg/lib/libnodeid.dll
/pkg/lib/libdebug.dll
/pkg/lib/lib_procfs_util.dll 0xfc24d000 0x00004e2c 0xfc1e6bd0 0x000002a8
/pkg/lib/libsysdb.dll
/pkg/lib/libsysdbutils.dll 0xfc29a000 0x0000ae04 0xfc29979c 0x000003ec
/pkg/lib/libwd_evm.dll
/pkg/lib/lib_mutex_monitor.dll 0xfc35e000 0x00002414 0xfc340850 0x00000128
/pkg/lib/libchkpt.dll
/pkg/lib/libpacket_common.dll 0xfc617000 0x000130f0 0xfc6056a0 0x000007b0
Cisco ASR 14000 Series Router System Management Command Reference
SMR-514
Follow all live threads of a given process or a given thread of a process and print stack trace in a
format similar to core dump output.
Follow a process in a loop for a given number of iterations.
Set a delay between two iterations while invoking the command.
Set the priority at which this process should run while this command is being run.
Dump memory from a given virtual memory location for a given size.
Display register values and status information of the target process.
Operations
read
Text addr. Text size
0xfc0c9000 0x0000c398 0xfc0c31f0 0x0000076c
0xfc0e3000 0x0000aeac 0xfc0c395c 0x00000388
0xfc0ee000 0x000332ec 0xfc122000 0x00000c70
0xfc123000 0x0002c4bc 0xfc150000 0x00002000
0xfc152000 0x00077ae0 0xfc1ca000 0x00002000
0xfc1d4000 0x0000530c 0xfc122c70 0x00000308
0xfc1e7000 0x000091fc 0xfc1e61a8 0x00000208
0xfc23e000 0x0000ef64 0xfc1e6680 0x00000550
0xfc252000 0x00046224 0xfc299000 0x0000079c
0xfc2a9000 0x0000481c 0xfc299b88 0x00000188
0xfc477000 0x0002ee04 0xfc474388 0x00000950
Process and Memory Management Commands on Cisco IOS XR Software
Data addr. Data size Version
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
OL-17231-01