1 11/01/76  page_trace, pgt
 2 
 3 Syntax:  pgt {N} {-control_args}
 4 
 5 
 6 Function: prints a recent history of page faults and other system events within
 7 the calling process.
 8 
 9 
10 Arguments:
11 N
12    print last N system events. (DEFAULT-- print all events in trace list.)
13 
14 
15 Control arguments:
16 -long, -lg
17    print full pathname where appropriate. (DEFAULT -- entrynames only.)
18 -no_header, -nhe
19    do not print header preceding output.
20 -from STR, -fm STR
21    start printing at first user-marker matching STR.
22 -to STR
23    stop printing at first user-marker matching STR.
24 -output_switch swname, -os swname
25    write output on swname, which must be attached and open.
26 -no_pagefaults, -npf
27    omit output about pagefaults.
28 
29 
30 Notes: Segment numbers can be reused within a process. Since it is the segment
31 numbers that are stored in the trace list, the pathnames and entrynames printed
32 by pgt may correspond to present initiations of a segment as opposed to those
33 in effect when the fault was recorded in the trace list.
34   Typically, any single invocation of a program does not produce a pagefault on
35 every page referenced by the program. Several traces may be needed to fully
36 identify the extent of pages used. The cumulative_page_trace (cpt) command is
37 useful for this purpose.