ncab2clf(1) - osol9

1ncab2clf(1)                      User Commands                     ncab2clf(1)
2
3
4

NAME

6       ncab2clf - convert binary log file to Common Log File format
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

EXIT STATUS

89       The following exit values are returned:
90
91       0     The file converted successfully
92
93
94       >0    An error occurred.
95
96

ATTRIBUTES

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

NOTES

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)