1ncab2clf(1) User Commands ncab2clf(1)
2
3
4
6 ncab2clf - convert binary log file to Common Log File format
7
9 /usr/bin/ncab2clf [-Dhv] [-i input-file] [-o output-file]
10 [-b size] [-n number] [-s datetime]
11
12
14 The ncab2clf command is used to convert the log file generated by the
15 Solaris Network Cache and Accelerator ("NCA") from binary format, to
16 Common Log File ("CLF") format. If no input-file is specified, ncab2clf
17 uses stdin. If no output-file is specified, the output goes to stdout.
18
20 -b Specifies the binary-log-file blocking in kilobytes;
21 the default is 64 Kbyte.
22
23
24 -D Specifies that direct I/O be disabled.
25
26
27 -h Prints usage message.
28
29
30 -i input-file Specifies the input file.
31
32
33 -n number Output number CLF records.
34
35
36 -o output-file Specifies the output file.
37
38
39 -s datetime Skip any records before the date and time specified
40 in datetime. You can specify the date and time in CLF
41 format or in the format specified by the touch(1)
42 utility. CLF format is the dominant format, so
43 ncab2clf first analyzes datetime assuming CLF.
44
45
46 -v Provides verbose output.
47
48
50 Example 1 Converting a Binary File to a Common Log File Format
51
52
53 The following example converts the binary file /var/nca/logs/nca.blf to
54 a file /var/nca/logs/nca.clf, which is in Common Log File format.
55
56
57 example% ncab2clf -D -i /var/nca/logs/nca.blf -o /var/nca/logs/nca.clf
58
59
60
61 Example 2 Converting Multiple Log Files
62
63
64 The following script may be used to convert multiple log files. The
65 directory designated by "*" must only contain log files.
66
67
68 !/bin/ksh
69 for filename in *
70 do
71 ncab2clf -D < $filename > $filename.clf
72 done
73
74
75 Example 3 Using -s and -n on a Raw Device
76
77
78 The following example shows how ncab2clf can be used on a raw device.
79 If not using the -n option, the default is to convert all records from
80 the starting location to the end of the file. The date and time speci‐
81 fied with -s, below, is in CLF format.
82
83
84 example% ncab2clf -s '10/Apr/2001:09:23:13' -n 100 < /dev/dsk/c2t1d0s6
85
86
87
89 The following exit values are returned:
90
91 0 The file converted successfully
92
93
94 >0 An error occurred.
95
96
98 See attributes(5) for descriptions of the following attributes:
99
100
101
102
103 ┌─────────────────────────────┬─────────────────────────────┐
104 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
105 ├─────────────────────────────┼─────────────────────────────┤
106 │Availability │SUNWncau │
107 ├─────────────────────────────┼─────────────────────────────┤
108 │Interface Stability │Evolving │
109 └─────────────────────────────┴─────────────────────────────┘
110
112 nca(1), ncakmod(1), nca.if(4), ncakmod.conf(4), ncalogd.conf(4),
113 attributes(5)
114
115
116 System Administration Guide: IP Services
117
119 The binary log files generated by NCA can become very large. When con‐
120 verting these large binary files, use the -b option to the ncab2clf
121 command to help performance.
122
123
124 Direct I/O is a benefit to the user if the data being written does not
125 come in as large chunks. However, if the user wishes to convert the log
126 file in large chunks using the -b option, then direct I/O should be
127 disabled by using the -D option.
128
129
130
131SunOS 5.11 28 Sep 2001 ncab2clf(1)