ncab2clf(1)
NAME
ncab2clf - convert binary log file to Common Log File format
SYNOPSIS
/usr/bin/ncab2clf [-Dhv] [-i input-file] [-o output-file]
[-b size] [-n number] [-s datetime]
DESCRIPTION
The ncab2clf command is used to convert the log file gen-
erated by the Solaris Network Cache and Accelerator ("NCA")
from binary format, to Common Log File ("CLF") format. If no
input-file is specified, ncab2clf uses stdin. If no output-
file is specified, the output goes to stdout.
OPTIONS
-b Specifies the binary-log-file blocking in kilo-
bytes; the default is 64 Kbyte.
-D Specifies that direct I/O be disabled.
-h Prints usage message.
-i input-file
Specifies the input file.
-n number
Output number CLF records.
-o output-file
Specifies the output file.
-s datetime
Skip any records before the date and time speci-
fied in datetime. You can specify the date and
time in CLF format or in the format specified by
the touch(1) utility. CLF format is the dominant
format, so ncab2clf first analyzes datetime
assuming CLF.
-v Provides verbose output.
EXAMPLES
Example 1: Converting a Binary File to a Common Log File
Format
The following example converts the binary file
/var/nca/logs/nca.blf to a file /var/nca/logs/nca.clf, which
is in Common Log File format.
example% ncab2clf -D -i /var/nca/logs/nca.blf -o /var/nca/logs/nca.clf
Example 2: Converting Multiple Log Files
The following script may be used to convert multiple log
files. The directory designated by "*" must only contain log
files.
!/bin/ksh
for filename in *
do
ncab2clf -D < $filename > $filename.clf
done
Example 3: Using -s and -n on a Raw Device
The following example shows how ncab2clf can be used on a
raw device. If not using the -n option, the default is to
convert all records from the starting location to the end of
the file. The date and time specified with -s, below, is in
CLF format.
example% ncab2clf -s '10/Apr/2001:09:23:13' -n 100 < /dev/dsk/c2t1d0s6
EXIT STATUS
The following exit values are returned:
0 The file converted successfully
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWncau |
|_____________________________|_____________________________|
| Interface Stability | Evolving |
|_____________________________|_____________________________|
SEE ALSO
nca(1), ncakmod(1), nca.if(4), ncakmod.conf(4),
ncalogd.conf(4), attributes(5)
System Administration Guide: IP Services
NOTES
The binary log files generated by NCA can become very large.
When converting these large binary files, use the -b option
to the ncab2clf command to help performance.
Direct I/O is a benefit to the user if the data being writ-
ten does not come in as large chunks. However, if the user
wishes to convert the log file in large chunks using the -b
option, then direct I/O should be disabled by using the -D
option.
Man(1) output converted with
man2html