![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to bsclog.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc|
Return to bsclog.8 CVS log | Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc |
1.1 root 1: .TH BSCLOG 8 1.2 DLBA
2: \" @(#)bsclog.8 1.2
3: .SH NAME
4: bsclog \- BISYNC Batch Audit Trail Utility
5: .SH SYNOPSIS
6: .nf
7: .I
8: bsclog hostname [-purge=dd] [-from=[yymmdd]hhmm]
9: .I
10: [-to=[yymmdd]hhmm]
11: .I
12: [-class=cccc] [-user=uuuu]
13: .fi
14: .SH DESCRIPTION
15: .P
16: The
17: .I bsclog
18: utility is used to selectively
19: print audit trail information and to purge old information from
20: the file to keep the size of the file to reasonable limits.
21: .P
22: A
23: .I hostname
24: must be specified. The primary audit trail
25: file is named /usr/spool/bscbatch/<hostname>/AUDIT.
26: Other audit trail files containing auxiliary information may be
27: present in the same directory;
28: they will be named AUDIT.nnnnn, where nnnnn is a number.
29: Auxiliary audit trail files may be created if the primary file is locked;
30: .I bsclog
31: will automatically merge these files with the primary files and
32: remove the auxiliary files when it is invoked.
33: .P
34: The
35: .I -purge
36: option is used to purge from the audit trail file any entries over
37: .I dd
38: days old.
39: If this option is selected, printing of the audit trail will not
40: occur.
41: .P
42: The remaining parameters are associated with the selective printing
43: of the audit trail file.
44: They may not be used if the
45: .I -purge
46: parameter is selected.
47: The
48: .I -from
49: and
50: .I -to
51: parameters
52: are used to select a time interval from which audit entries are to
53: be printed.
54: The
55: .I yymmdd
56: part of the parameter is used to select a year, month, and day;
57: default is the current date.
58: The
59: .I hhmm
60: part selects a particular hour and minute.
61: If
62: .I -from
63: is not given, the beginning of time is
64: used for the beginning of the time interval; if
65: .I -to
66: is not given, the end of time is used.
67: The
68: .I -user
69: parameter is used to select entries made while a file was being sent
70: which belonged to a specific user (with id
71: .I uuuu).
72: Information on the user for files being received is not
73: available at the time the file is being received, and thus does not
74: appear in the audit trail. If
75: .I -user
76: is not specified,
77: no selection of particular users is made and thus all entries print.
78: .P
79: Each entry in the audit trail has a single character
80: class code, as shown in the list of audit trail messages to follow.
81: Selection of specific class codes may be performed with the
82: .I -class
83: parameter, for example,
84: .I -class=ct
85: selects records of class 'c' and 't',
86: which corresponds to information on connections and statistics.
87: .SH "AUDIT TRAIL MESSAGES"
88: .P
89: Each message below is preceded by its message class in {}'s.
90: .P
91: {C} Ready for connect via <devname>
92: .IP
93: Written just before calling the
94: .I connect
95: routine (see bscbatch(8)) and opening <devname>.
96: .P
97: {C} Connected [- host id is <ident>]
98: .IP
99: Connection to host is complete.
100: If the host supplied an identification as part of its bid response,
101: the identification is shown.
102: .P
103: {C} Connection failed - <reason>
104: .IP
105: Reasons include:
106: .RS
107: .TP
108: Bid count exceeded
109: (host probably dead)
110: .TP
111: Modem failure
112: (no CTS, or no TxC - check cables and jumpers)
113: .TP
114: Wrong host name (<hostid>)
115: (wrong host called)
116: .RE
117: .P
118: {S} Sending SIGNON file <filename>
119: .IP
120: The installation-specified 'signon' file is being sent.
121: .P
122: {S} Transmission of <filename> ([transparent,] nnnnn bytes) begun
123: .IP
124: The file's length in bytes is shown.
125: If the file was sent in transparent mode, that information is shown.
126: .P
127: {S} Transmission of <filename> completed (nnn blocks)
128: .IP
129: The actual number of blocks sent is shown.
130: .P
131: {S} Transmission of <filename> aborted, <reason>
132: .IP
133: Reasons include:
134: .RS
135: .TP
136: Error reading file
137: .TP
138: Retry limit exceeded
139: (transmission error or host dead)
140: .TP
141: WACK limit exceeded
142: (host delays)
143: .TP
144: Line disconnect
145: (modem dropped DSR)
146: .TP
147: Modem error
148: (no clock, or no CTS)
149: .TP
150: Protocol error
151: .TP
152: RVI abort
153: .TP
154: Bid limit exceeded
155: (host may be dead)
156: .TP
157: Host aborted transmission
158: (host sent EOT)
159: .RE
160: .P
161: {T} EOT, sent nnn blocks, did nnn TTDs, had nnn NAKs, nnn timeouts, nnn WACKs.
162: .IP
163: The number of blocks successively transmitted is shown,
164: along with statistics as to the number of times transmission was
165: delayed (TTDs), number of noise errors (NAKs), number of times there
166: was no response (usually due to noise as well), and the number of
167: times the remote host was temporarily not prepared to take additional
168: data (WACKs).
169: .P
170: {R} Receiving <type> file[, transparent mode]
171: .IP
172: A file is being received;
173: .IR <type> is print or punch
174: If the file is being sent in transparent mode, it is so indicated.
175: .P
176: {R} Receiving complete (nnnnn bytes, nnn blocks), assigned to file <filename>
177: .IP
178: The number of blocks received is shown, as well as the number of
179: bytes placed into file <filename>. The filename given is the one
180: returned by the installation
181: .I asgnfile
182: exit routine, see batch(8).
183: .P
184: {R} Receiving aborted, <reason>
185: .IP
186: Reasons include:
187: .RS
188: .TP
189: Error writing file
190: .TP
191: Protocol error
192: .TP
193: NAK limit exceeded
194: (noise errors)
195: .TP
196: TTD limit exceeded
197: (host may be dead)
198: .TP
199: Line disconnect
200: (modem dropped DSR)
201: .TP
202: Modem failure
203: (no CTS or no TxC)
204: .TP
205: Early EOF
206: (host sent EOT before last block)
207: .RE
208: .P
209: {T} EOT, received nnn blocks, did nn WACKs and nn NAKs, had nn TTDs, nn overruns.
210: .IP
211: The number of blocks successfully received is shown, along with statistics
212: as to the number of times this system had to request that the remote
213: host delay transmission of the next block (WACK), the number of noise
214: errors (NAKs), number of times the remote host delayed transmission
215: (TTDs), and the number of times incoming characters arrived faster
216: than they could be processed, which indicates this system was heavily
217: I/O loaded.
218: .P
219: {D} Disconnected, <reason>
220: .IP
221: Reasons include:
222: .RS
223: .TP
224: Line disconnected
225: (modem dropped DSR)
226: .TP
227: Inactivity timeout
228: .TP
229: Host signalled disconnect
230: (Host sent DLE-EOT sequence)
231: .RE
232: .P
233: {D} Sending SIGNOFF file <filename>
234: .P
235: The installation-specified termination file is being sent.
236: .SH "SEE ALSO"
237: .nf
238: .ta .8i 2.5i
239: bscbatch(8) - batch file submission / queue query
240: bscpr(1C) - batch file print utility
241: batch(8) - BISYNC Batch Terminal Emulation
242: .fi
243: .SH DIAGNOSTICS
244: .P
245: bsclog: <hostname> has no spool directory
246: .IP
247: Either the given host name is not a valid one, or it has no spool
248: directory (/usr/lib/bscbatch/<hostname>).
249: .P
250: bsclog: <hostname> has no AUDIT file
251: .IP
252: There is no file /usr/lib/bscbatch/<hostname>/AUDIT.
253: If one does not exist, no auditing is performed.
254: This message also occurs if the file exists,
255: but can't be opened for read and write.
256: .P
257: bsclog: not a numeric value (<flag>)
258: .IP
259: The parameter shown (<flag>) is supposed to have a numeric parameter.
260: .P
261: bsclog: no data meets selection requirements
262: .IP
263: None of the records in the audit trail file matches the selection
264: requirements as given.
265: .P
266: bsclog: can't create temporary file
267: .IP
268: The temporary file which is to hold the result of the purge cannot be created.
269: It would go in /usr/spool/bscbatch/<hostname>.
270: .P
271: bsclog: can't combine audit files -- sort failure
272: .IP
273: The
274: .I sort(1)
275: utility is used to merge auxiliary
276: audit files with the primary audit file.
277: The sort could not be properly executed;
278: the data in the auxiliary files will not be combined with
279: the primary file at this time.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.