Leaked source code of windows server 2003
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
Installing and Using Profile.exe Windows NT Sampling Profiler
Windows NT v4.0
Overview:
The Windows NT Sampling Profiler is an easy to use tool that recordsthe how often each function of an application is called during thecourse of that application.
Installation:
Required Files: PROFILE.EXE Windows NT Sampling Profiler Installed from the SDK PSAPI.DLL Process Support API Library Installed from the SDK
Before trying to use the Sampling Profile make sure the requiredfiles listed above are in the path.
Use:
Required Environment Variables:
The Sampling profiler must have access to the image's symbols in order to produce the most meaningful output. The sybmols are searched in the path described by the
_NT_SYMBOL_PATH
environment variable. Be sure to set this variable to the correct path before attempting the profile.
Command Line Arguments:
Usage: profile [/a] [/innn] [/k] name-of-image [parameters]... /a All hits /bnnn Set profile bucket size to 2 to the nnn bytes /ffilename Output to filename /innn Set profile interval to nnn (in 100ns units) /k profile system modules /s[profilesource] Use profilesource instead of clock interrupt /S[profilesource] Use profilesource as secondary profile source
/a will display ALL hits or addresses that were sampled during the test run. Normally the hits are summarized by function.
/bnnn Sets the profile bucket size (in bytes) to use. The default is 4 bytes. This determines the sample address granularity.
/ffilename set the output file that is produced when the sampled program terminates. The defalt for this is "profile.out"
/innn Sets the sample interval in 100 nS units. The default value is 488.2 microseconds (or /i4882)
/k allows processing of system functions that are called by the process being profiled. Normally on the the user mode functions of the process are profiled.
/sprofilesource changes the profile sample interrupt from the clock interrupt to another source. This option is not supported on all platforms, however.
ALPHA Options: align totalissues pipelinedry loadinstructions pipelinefrozen branchinstructions totalnonissues dcachemisses icachemisses branchmispredicts storeinstructions
MIPS options: align
/Sprofilesource same options as above only this selects the secondary profile interrupt source
Sample Command Lines:
profile myprog.exe
profiles the program "myprog.exe" using the default settings and monitoring only the user mode functions. The output is written to the default filename of "profile.out" in the default directory.
profile /k /fMyProg.dat myprog.exe
profiles the program "myprog.exe" using the default settings and monitoring both the user mode and the kernel mode functions executed by this process The output is written to the user specified filename of "MyProg.dat" in the default directory.
While the program being profiled runs, the instruction pointer is being sampled periodicaly and profile records the value of the instruction pointer each time the sample occurs inside the profiled process. When theprogram terminates the recorded address values are looked up in the symbolfiles to determine the function being run at the time. The tabulation of the results is then output to the specified, or default, filename.
The output consists of 3 comma separated fields. The first field is the number of times a sample occured in the function. The second field is the name of the module containing that function and the third field is thename of the function within the module followed by it's virtual address. In a verbose listing each of these function entries is followed by a listing of the actual addresses that were sampled.
|
