man/man1/ncab2clf.1

         te
 Copyright (C) 2001, Sun Microsystems, Inc. All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 NCAB2CLF 1 "Sep 28, 2001"
 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 generated 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 kilobytes; 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 specified 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 attributes:


ATTRIBUTE TYPE ATTRIBUTE VALUE
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 written 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.