unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

ncab2clf(1)                      User Commands                     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 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 for-
                       mat 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  speci-
       fied 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



       >&gt;0              An error occurred.




ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE  VALUE   AvailabilitySUNWncau
       Interface StabilityEvolving


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  con-
       verting  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.10                        28 Sep 2001                      ncab2clf(1)