Home Man
Today's Posts

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for ncab2clf (opensolaris section 1)

ncab2clf(1)				  User Commands 			      ncab2clf(1)

       ncab2clf - convert binary log file to Common Log File format

       /usr/bin/ncab2clf [-Dhv] [-i input-file] [-o output-file]
	    [-b size] [-n number] [-s datetime]

       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.

       -b		 Specifies the binary-log-file blocking in kilobytes; the default  is  64

       -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.

       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.

	 for filename in *
	     ncab2clf -D < $filename > $filename.clf

       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

       The following exit values are returned:

       0     The file converted successfully

       >0    An error occurred.

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

       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWncau			   |
       |Interface Stability	     |Evolving			   |

       nca(1), ncakmod(1), nca.if(4), ncakmod.conf(4), ncalogd.conf(4), attributes(5)

       System Administration Guide: IP Services

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

All times are GMT -4. The time now is 12:48 AM.

All times are GMT -4. The time now is 12:48 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
Show Password