ncab2clf(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES

NAME

ncab2clf- convert binary log file to Common Log File format

SYNOPSIS

/usr/bin/ncab2clf [-Dhv] [-i input-file] [-o output-file] [-b size]

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.

-o output-file

Specifies the output file.

-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

---

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
Availability	SUNWncau
Interface Stability	Evolving

SEE ALSO

attributes(5)

System Administration Guide, Volume 3

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.

SunOS 5.8  Last Revised 1 Oct 1999

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES