Process Interrupt Mask Profiler Enhancement
The Process Interrupt Mask Profiler Enhancement feature collects information about processes that have masked interrupts. This feature is useful in identifying how many times a process has masked interrupts and how much time a process has spent in an interrupt masked state since the profiling was enabled.
History for the Process Interrupt Mask Profiler Enhancement Feature
Release
12.4(2)T
Modification
This feature was introduced.
Contents
•
•
•
•
Information About the Process Interrupt Mask Profiler Enhancement, page 1
How to Use the Process Interrupt Mask Profiler, page 2
Additional References, page 5
Command Reference, page 6
Information About the Process Interrupt Mask Profiler
Enhancement
To configure the Process Interrupt Mask Profiler Enhancement feature, you should understand the following concept:
•
Process Interrupt Mask Profiler Detail Collection, page 1
Process Interrupt Mask Profiler Detail Collection
The Process Interrupt Mask Profiler Enhancement feature improves the diagnostic ability of the Process
Interrupt Mask Profiler tool by including the collection of the following details:
Corporate Headquarters:
Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA
© 2005 Cisco Systems, Inc. All rights reserved.
Process Interrupt Mask Profiler Enhancement
How to Use the Process Interrupt Mask Profiler
• The total amount of time a process has masked interrupts (either by calling disable_interrupts or raise_interrupt_level, or emt_call) since the Process Interrupt Mask Profiler has been enabled.
• The number of times a process has masked interrupts (either by calling disable_interrupts or raise_interrupt_level, or emt_call) since the Process Interrupt Mask Profiler has been enabled.
In addition, the Process Interrupt Mask Profiler feature adds ability to account for the time spent in emt_call.
How to Use the Process Interrupt Mask Profiler
This section contains the following tasks:
•
•
Configuring the Process Interrupt Mask Profiler, page 2
Displaying Process Interrupt Mask Profiling Details, page 3
Configuring the Process Interrupt Mask Profiler
Perform this task to configure the Process Interrupt Mask Profiler Enhancement feature.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
enable configure terminal scheduler interrupt mask time threshold-time scheduler interrupt mask size buffersize scheduler interrupt mask profile exit
DETAILED STEPS
Command or Action
Step 1 enable
Purpose
Enables privileged EXEC mode.
• Enter your password if prompted.
Example:
Router> enable
Step 2 configure terminal Enters global configuration mode.
Example:
Router(config)# configure terminal
Step 3 scheduler interrupt mask time threshold-time
Example:
Router(config)# scheduler interrupt mask time
100
(Optional) Configures the maximum time that a process can run with interrupts masked before another entry is created in the interrupt mask buffer. The default is 50 microseconds.
• This example sets the value to 100 microseconds.
2
Cisco IOS Release 12.4(2)T
Process Interrupt Mask Profiler Enhancement
How to Use the Process Interrupt Mask Profiler
Command or Action
Step 4 scheduler interrupt mask size buffersize
Example:
Router(config)# scheduler interrupt mask size
100
Step 5 scheduler interrupt mask profile
Purpose
(Optional) Specifies the number of entries that can exist in the interrupt mask buffer. The default value is 50 entries.
• This example sets the number of entries to 100.
Enables process interrupt mask profiling on the system.
Example:
Router(config)# scheduler interrupt mask profile
Step 6 exit Exits global configuration mode.
Example:
Router(config)# exit
Configuration Example for the Process Interrupt Mask Profiler Enhancment
The following example show enabling the process interrupt mask profiler, setting the amount of time a process can run with interrupts masked to 100 microseconds, and the maximum number of entries in the interrupt mask buffer to 100.
Router(config)# scheduler interrupt mask time 100
Router(config)# scheduler interrupt mask size 100
Router(config)# scheduler interrupt mask profile
Displaying Process Interrupt Mask Profiling Details
Perform this task to display the contents of the interrupt mask buffer.
SUMMARY STEPS
1.
2.
3.
enable show processes interrupt mask buffer show processes interrupt mask detail [ pid ]
Cisco IOS Release 12.4(2)T
3
Process Interrupt Mask Profiler Enhancement
How to Use the Process Interrupt Mask Profiler
DETAILED STEPS
Step 1 enable Enables privileged EXEC mode.
• Enter your password if prompted.
Example:
Router> enable
Step 2 show processes interrupt mask buffer Displays the stack trace and relevant information about places where interrupts have been masked for more than the configured threshold time.
Example:
Router# show processes interrupt mask buffer
Step 3 show processes interrupt mask buffer detail
[ pid ]
Example:
Router# show processes interrupt mask detail 2
Displays the total time (accumulative) and the number of times interrupts have been masked by for a spcific process.
• This example shows how to display this information for the process with the PID 2.
Example
To display the contents of the interrupt mask buffer, use the following command:
Router# show processes interrupt mask buffer
Allowable interrupt mask time : 50 micro seconds
Allowable number of half pipeline ticks for this platform : 5000
Buffer Size : 50 entries
NETS Disable : 3
TTY Disable : 4
ALL Disable : 4
emt_call : 11
disable_interrupts : 12
PID Level Time Spent(us) Count Stack Trace
0x608C3C14 0x60894748 0x6089437C 0x608943AC 3 11 60 1
0x609CEC88 0x609CECFC 0x609C8524
3 11 322 1
0x609C8524 0x60867C28 0x607C70B0
3 4 147 1
0x607E27F0 0x607E27C0 0x607E50B0
0x608C3C14 0x608943BC 0x609CEC88 0x609CECFC
0x6078AED4 0x6078BE94 0x6078C750 0x6078C8D4
To display information about total amount of time and number of times interrupts have been masked by all processes, use the following command:
Router# show processes interrupt mask detail
PID Time Spent(us) Count Process Name
2
3
5
6388
7957
6710
1791 Load Meter
16831 Exec
2813 Check heaps
4
Cisco IOS Release 12.4(2)T
Process Interrupt Mask Profiler Enhancement
Additional References
To display total time (accumulative) and number of times interrupts have been masked by aprocess with the PID 2, use the following command:
Router# show processes interrupt mask detail 2
Process ID : 2
Process Name : Load Meter
Total Interrupt Masked Time : 6586 (us)
Total Interrupt Masked Count : 1845
Additional References
The following sections provide references related to the Process Interrupt Mask Profiler Enhancement feature.
Related Documents
Related Topic
Basic router configuration information
Document Title
Cisco IOS Configuration Fundamentals Configuration Guide ,
Release 12.4
Standards
Standard
None
MIBs
MIB
None
Title
—
MIBs Link
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: http://www.cisco.com/go/mibs
RFCs
RFC
None
Title
—
Cisco IOS Release 12.4(2)T
5
Process Interrupt Mask Profiler Enhancement
Command Reference
Technical Assistance
Description
The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.
Link http://www.cisco.com/techsupport
Command Reference
This section documents the following new commands only.
•
•
•
•
•
•
clear processes interrupt mask detail
scheduler interrupt mask profile
scheduler interrupt mask size
scheduler interrupt mask time
show processes interrupt mask buffer
show processes interrupt mask detail
6
Cisco IOS Release 12.4(2)T
Process Interrupt Mask Profiler Enhancement
clear processes interrupt mask detail
clear processes interrupt mask detail
To clear interrupt mask details for all processes in the interrupt mask buffer, use the clear processes interrupt mask detail command in privileged EXEC mode.
clear processes interrupt mask detail
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release
12.4(2)T
Modification
This command was introduced.
Examples The following example how to the clear interrupt mask details for all processes:
Router# clear processes interrupt mask detail
Related Commands Command show process interrupt mask buffer show processes interrupt mask detail scheduler interrupt mask profile scheduler interrupt mask time scheduler interrupt mask size
Description
Displays the information stored in the interrupt mask buffer.
Displays interrupt masked details for the specified processes or all processes in the system.
Starts interrupt mask profiling for all processes running on the system
Configures the maximum time that a process can run with interrupts masked.
Configures the maximum number of entries that can exist in the interrupt mask buffer.
Cisco IOS Release 12.4(2)T
7
Process Interrupt Mask Profiler Enhancement
scheduler interrupt mask profile
scheduler interrupt mask profile
To start interrupt mask profiling for all processes running on the system, use the scheduler interrupt mask profile command in global configuration mode. To stop interrupt mask profiling, use the no form of this command.
scheduler interrupt mask profile no scheduler interrupt mask profile
Syntax Description This command has no arguments or keywords.
Defaults Interrupt mask profiling is disabled by default.
Command Modes Global configuration
Command History Release
12.4(2)T
Modification
This command was introduced.
Usage Guidelines This command enables the collection of details regarding the total amount of time a process has masked interrupts since the interrupt mask profiler was enabled.
Examples The following example shows how to enable interrupt mask profiling:
Router(config)# scheduler interrupt mask profile
Related Commands Command clear processes interrupt mask detail scheduler interrupt mask size scheduler interrupt mask time show process interrupt mask buffer show processes interrupt mask detail
Description
Clears the interrupt masked details for all processes and stack traces that have been dumped into the interrupt mask buffer.
Configures the maximum number of entries that can exist in the interrupt mask buffer.
Configures the maximum allowed time that a process can run with interrupts masked.
Displays the information stored in the interrupt mask buffer.
Displays interrupt masked details for the specified process or all processes in the system.
8
Cisco IOS Release 12.4(2)T
Process Interrupt Mask Profiler Enhancement
scheduler interrupt mask size
scheduler interrupt mask size
To configure the maximum number of entries that can exist in the interrupt mask buffer, use the scheduler interrupt mask size command in global configuration mode. To reset the maximum number of entries that can exist in the interrupt mask buffer to the default, use the no form of this command.
scheduler interrupt mask size buffersize no scheduler interrupt mask size
Syntax Description buffersize Specifies the number of entries that can exist in the interrupt mask buffer.
Defaults The default buffer size is 50 entries.
Command Modes Global configuration
Command History Release
12.4(2)T
Modification
This command was introduced.
Examples The following example shows how to configure 100 entries the maximum number of entries that can exist in the interrupt mask buffer:
Router(config)# scheduler interrupt mask size 100
Related Commands Command clear processes interrupt mask detail scheduler interrupt mask profile scheduler interrupt mask time show processes interrupt mask buffer show processes interrupt mask detail
Description
Clears the interrupt masked details for all processes and stack traces that have been dumped into the interrupt mask buffer.
Enables or disables interrupt mask profiling for all processes running on the system.
Configures the maximum amount of time a process can run with interrupts masked.
Displays interrupt masked details for the specified process or all processes in the system and displays information stored in the interrupt mask buffer.
Displays interrupt masked details for the specified or all processes in the system.
Cisco IOS Release 12.4(2)T
9
Process Interrupt Mask Profiler Enhancement
scheduler interrupt mask time
scheduler interrupt mask time
To configure the maximum time that a process can run with interrupts masked before another entry is created in the interrupt mask buffer, use the scheduler interrupt mask time command in global configuration mode. To reset the threshold time to the default, use the no form of this command.
scheduler interrupt mask time threshold-time no scheduler interrupt mask time
Syntax Description threshold-time Specifies the maximum amount of time a process can be in interrupt masked state without creating an entry in the interrupt mask buffer.
Defaults The default threshold time value is 50 microseconds.
Command Modes Global configuration
Command History Release
12.4(2)T
Modification
This command was introduced.
Usage Guidelines This command configures the maximum time allowed that a process can run with interrupts masked.
Examples The following shows how to configure 100 microseconds as the maximum time a process can run with interrupts masked before another entry is created in the interrupt mask buffer:
Router(config)# scheduler interrupt mask time 100
Related Commands Command clear processes interrupt mask detail scheduler interrupt mask profile scheduler interrupt mask size show processes interrupt mask buffer show processes interrupt mask detail
Description
Clears the interrupt masked details for all processes and stack traces that have been dumped into the interrupt mask buffer.
Enables or disables interrupt mask profiling for all processes running on the system.
Configures the maximum number of entries that can exist in the interrupt mask buffer.
Displays the information stored in the interrupt mask buffer.
Displays interrupt masked details for the specified process or all processes in the system.
10
Cisco IOS Release 12.4(2)T
Process Interrupt Mask Profiler Enhancement
show processes interrupt mask buffer
show processes interrupt mask buffer
To display information in the interrupt mask buffer, use the show processes interrupt mask buffer command in privileged EXEC mode. show processes interrupt mask buffer buffer Displays stack trace and information about the places where interrupts have been masked more than the configured threshold time.
Command Modes Privileged EXEC
Command History Release
12.4(2)T
Examples
Modification
This command was introduced.
The following is sample output from the show processes interrupt mask buffer command. The output displays stack trace and relevant information about the places where interrupts have been masked more than the configured threshold time:
Router# show processes interrupt mask buffer
Allowable interrupt mask time : 50 micro seconds
Allowable number of half pipeline ticks for this platform : 5000
Buffer Size : 50 entries
NETS Disable : 3
TTY Disable : 4
ALL Disable : 4
emt_call : 11
disable_interrupts : 12
PID Level Time Spent(us) Count Stack Trace
3 11 360 1
0x609CEC88 0x609CECFC 0x609C8524
3 4 147 1
0x607E27F0 0x607E27C0 0x607E50B0
0x608C3C14 0x60894748 0x6089437C 0x608943AC
3 11 322 1 0x608C3C14 0x608943BC 0x609CEC88 0x609CECFC
0x609C8524 0x60867C28 0x607C70B0
0x6078AED4 0x6078BE94 0x6078C750 0x6078C8D4
Related Commands Command clear processes interrupt mask detail scheduler interrupt mask profile scheduler interrupt mask time
Description
Clears the interrupt masked details for all processes and stack traces which have been dumped into the interrupt mask buffer.
Enables or disables interrupt mask profiling for all processes running on the system.
Configures the maximum amount of time a process can run with interrupts masked.
Cisco IOS Release 12.4(2)T
11
Process Interrupt Mask Profiler Enhancement
show processes interrupt mask buffer
Command scheduler interrupt mask size show processes interrupt mask detail
Description
Configures the maximum number of entries that can exist in the interrupt mask buffer.
Displays interrupt masked details for the specified process or all processes in the system.
12
Cisco IOS Release 12.4(2)T
Process Interrupt Mask Profiler Enhancement
show processes interrupt mask detail
show processes interrupt mask detail
To display information about interrupt masking, use the show processes interrupt mask detail command in privileged EXEC mode. show processes interrupt mask detail [ pid ]
Syntax Description detail pid
Displays information about the total amount of time and the number of times interrupts have been masked by all processes.
(Optional) An integer that specifies the process id for which to display the total accumulated time and the number of times interrupts have been masked.
Command Modes Privileged EXEC
Command History
Examples
Release
12.4(2)T
Modification
This command was introduced.
The following is sample output from the show processes interrupt mask detail command. the output displays information about the total amount of time and number of times interrupts have been masked by all processes:
Router# show processes interrupt mask detail
PID Time Spent(us) Count Process Name
2
3
5
6388
7957
6710
1791
2813
Load Meter
16831 Exec
Check heaps
The following is sample output from the show processes interrupt mask detail command with the process
ID specified. The output displays the total time (accumulative), number of times interrupts have been masked by a specific process:
Router# show processes interrupt mask detail 2
Process ID : 2
Process Name : Load Meter
Total Interrupt Masked Time : 6586 (us)
Total Interrupt Masked Count : 1845
Related Commands Command clear processes interrupt mask detail scheduler interrupt mask profile
Description
Clears the interrupt masked details for all processes and stack traces which have been dumped into the interrupt mask buffer.
Enables or disables interrupt mask profiling for all processes running on the system.
Cisco IOS Release 12.4(2)T
13
Process Interrupt Mask Profiler Enhancement
show processes interrupt mask detail
Command scheduler interrupt mask time scheduler interrupt mask size show processes interrupt mask detail
Description
Configures the maximum amount of time a process can run with interrupts masked.
Configures the maximum number of entries that can exist in the interrupt mask buffer.
Displays interrupt masked details for the specified process or all processes in the system.
CCVP, the Cisco logo, and Welcome to the Human Network are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn is a service mark of Cisco Systems, Inc.; and Access Registrar, Aironet, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco
Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity,
Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream, Linksys, MeetingPlace, MGX, Networkers,
Networking Academy, Network Registrar, PIX, ProConnect, ScriptShare, SMARTnet, StackWise, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0711R)
© 2005 Cisco Systems, Inc. All rights reserved.
14
Cisco IOS Release 12.4(2)T
