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