Return to bsclog.8 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc

Annotation of cci/usr/src/usr.bin/bsc/doc/bsclog.8, revision 1.1

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.