1.\" 2.\" Copyright (c) 2003,2004 The DragonFly Project. All rights reserved. 3.\" 4.\" This code is derived from software contributed to The DragonFly Project 5.\" by Matthew Dillon <dillon@backplane.com> 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 11.\" 1. Redistributions of source code must retain the above copyright 12.\" notice, this list of conditions and the following disclaimer. 13.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" notice, this list of conditions and the following disclaimer in 15.\" the documentation and/or other materials provided with the 16.\" distribution. 17.\" 3. Neither the name of The DragonFly Project nor the names of its 18.\" contributors may be used to endorse or promote products derived 19.\" from this software without specific, prior written permission. 20.\" 21.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 22.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 23.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 24.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 25.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 26.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, 27.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 28.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 29.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 30.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 31.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE. 33.\" 34.\" $DragonFly: src/usr.bin/pctrack/pctrack.8,v 1.1 2006/06/08 18:48:30 dillon Exp $ 35.\" 36.Dd Jun 8, 2006 37.Dt PCTRACK 8 38.Os 39.Sh NAME 40.Nm pctrack 41.Nd print kernel system/interrupt pc sampling history 42.Sh SYNOPSIS 43.Nm 44.Op Fl fnsi 45.Op Fl c Ar cpu 46.Op Fl N Ar execfile 47.Op Fl M Ar corefile 48.Op Ar interval 49.Sh DESCRIPTION 50Kernels compiled with DEBUG_PCTRACK record the program counter (PC) of 51the code interrupted by the statistics clock interrupt. 52This information can be dumped with the 53.Nm 54utility 55.Pp 56The following options are available: 57.Bl -tag -width ".Fl N Ar execfile" 58.It Fl c Ar cpu 59Specify which cpu to dump. If not specified, all cpus will be dumped. 60.It Fl f 61If a single cpu and either 62.Op Fl i 63or 64.Op Fl s 65is specified, this option will use the repeat interval to detect changes 66and dump them as they occur. 67.It Fl i 68Dump the interrupt tracking buffer. 69.It Fl s 70Dump the kernel tracking buffer. 71If neither 72.Op Fl i 73or 74.Op Fl s 75is specified, both tracking buffers will be dumped. 76.It Fl n 77.Nm 78normally tries to translate the PC into symbols. This option forces hex 79values to be displayed instead. 80.It Fl N Ar execfile 81The kernel image to resolve symbols from. 82The default is the value returned via 83.Xr getbootfile 3 . 84.It Fl M Ar corefile 85The core file or memory image to read from. 86The default is 87.Pa /dev/mem . 88.El 89.Sh OPERATIONAL NOTES 90.Sh HISTORY 91The 92.Nm 93utility first appeared in 94.Dx 1.5 . 95.Sh AUTHORS 96.An -nosplit 97The 98.Nm 99utility was originally implemented by 100.An Matthew Dillon 101for 102.Dx . 103