1 04/10/84 display_audit_file, daf
2
3 Syntax as a command: daf path -control_args
4
5
6 Function: displays the file produced by the audit_ I/O module.
7
8
9 Arguments:
10 path
11 is the pathname of the audit file to be displayed. If path is not
12 indicated, the audit file associated with the user_i/o switch is
13 assumed. If user_i/o is not being audited, the audit file currently
14 in use is displayed.
15
16
17 Control arguments:
18 -append_nl, -anl
19 appends new lines to the end of entries that do not end in a new
20 line. It overrides -no_append_nl to the left in the command line.
21 By default, new lines are appended if a "leader generating" control
22 argument i.e. -class_identifiers -entry_numbers or -metering is
23 present.
24
25
26 -class STR1 ...STRn
27 prints the entries having a class identifier matching any of the
28 STRs. Class identifiers are as follows:
29 EL, el edit line
30 IL, il input line
31 IC, ic input characters
32 OC, oc output characters
33 TM, tm trace of modes operations
34 TC, tc trace of control operations
35
36
37 If STR contains only one character, it is matched on the first
38 character of the class identifiers; for example, if STR is I,
39 entries having either IL or IC class identifiers are displayed. If
40 -class is not given, the audit file is displayed without class
41 identifiers.
42 -class_identifiers, -cli
43 displays the audit file with the class identifiers before each
44 entry. If -metering is also specified, the metering information
45 precedes class identifiers.
46 -entry_numbers, -etn
47 prints the entry numbers before each entry.
48 -exclude STR1 ...STRn, -ex STR1 ...STRn
49 excludes any entries containing strings matching any of the STRs.
50 If -exclude is not chosen, all selected entries are printed.
51
52
53 -from STR, -fm STR
54 specifies the first audit file entry to be displayed. If STR is a
55 positive integer, it is interpreted as an entry number. If STR is a
56 positive number containing a decimal point, it is interpreted as a
57 time in 24-hour format. If it is neither, the audit file is
58 displayed from the first entry that matches STR. If -from is not
59 supplied, the audit file is displayed from the beginning.
60 -insert_nl, -inl
61 inserts new lines whenever an entry is over length as determined by
62 -line_length or the current line length for the switch. Default
63
64
65 -last STR
66 displays entries beginning at the point specified by STR, starting
67 at the end of the audit file. If STR is in entry number format, the
68 first entry displayed is STR entries back from the end of the file.
69 If STR is in time format, the first entry is STR hours and minutes
70 from the end of the file. If STR is a character string, the first
71 entry contains a match for STR searching from the end of the file.
72 If -last is not selected, the audit file is displayed from the
73 beginning.
74 -line_length N, -ll N
75 inserts a new line after the character specified by N if a line of
76 output is greater than N characters long. A continuation line is
77 indented to allow for any entry descriptors produced by -metering,
78 -entry_numbers, or -class_identifiers and is preceded by an "*" to
79 indicate it is a continuation of the previous line.
80
81
82 -match STR1 ...STRn
83 prints entries containing strings matching any of the STRs. If it
84 is not specified, all selected entries are printed.
85 -metering, -mt
86 displays the audit file with metering information at the beginning
87 of each line, preceding the class identifiers if -class or
88 -class_identifiers is also used.
89 -next STR
90 displays a given number of entries from an explicit point in the
91 file to the point specified by STR. If STR is in entry number
92 format, the next STR entries are displayed. If STR is in time
93 format, the entries within the next STR period of time after the
94 beginning entry are displayed. If STR is a character string, the
95 entries up to the next match of STR are displayed. If -next is not
96 selected, all entries to the end of the file are displayed.
97
98
99 -no_append_nl, -nanl
100 does not append new lines to entries that do not end in a new line.
101 This control argument overrides the appending of new lines because
102 of "leader generating" control arguments or an occurrence to the
103 left in the command line of -append_nl.
104 -no_insert_nl, -ninl
105 does not insert new lines.
106 -output_file PATH, -of PATH
107 displays the audit file into the segment named PATH.
108 -reverse
109 prints the entries in reverse chronological order.
110
111
112 -string STR, -str STR
113 uses STR as a character string with no special interpretation. This
114 is useful for preventing STR from being interpreted as a control
115 argument, a time, or an entry number. It can be given with -from,
116 -to, -next, -last, -match, and -exclude, for example, "-from -string
117 81" see "Notes".
118 -switch STR
119 displays the audit file associated with the I/O switch specified by
120 STR if the I/O switch is currently attached. If the I/O switch is
121 not attached, an error message is printed. If -switch is not
122 chosen, the audit file associated with the user_i/o switch is
123 displayed.
124
125
126 -to STR
127 stops the display of the audit file at the point specified by STR,
128 where STR can have any of the values for -from. If -to is not
129 specified, the audit file is displayed up to the end.
130
131
132 Notes: You specify the format of the output, which entries are
133 selected to be output, and the file to which the output is directed.
134 See attach_audit and the audit_ I/O module.
135
136 The audit_meter mode must be on for there to be any metering
137 information in the audit file; without this information, time arguments
138 are invalid.
139
140 The -string control argument is useful in the following situations. To
141 pass 1005.2 as a character string to be matched, rather than a time
142 value for -from, type
143
144 daf -from -string 1005.2
145
146
147 To pass -last as a character string to -match, type
148
149 daf -match -string -last
150