Debian Codegraph @

examples/raconvert/README

raw
1 /*
2 * Argus-5.0 Client Software. Tools to read, analyze and manage Argus data.
3 * Copyright (c) 2000-2024 QoSient, LLC
4 * All rights reserved.
5 *
6 * THE ACCOMPANYING PROGRAM IS PROPRIETARY SOFTWARE OF QoSIENT, LLC,
7 * AND CANNOT BE USED, DISTRIBUTED, COPIED OR MODIFIED WITHOUT
8 * EXPRESS PERMISSION OF QoSIENT, LLC.
9 *
10 * QOSIENT, LLC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
11 * SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
12 * AND FITNESS, IN NO EVENT SHALL QOSIENT, LLC BE LIABLE FOR ANY
13 * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
15 * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
16 * ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
17 * THIS SOFTWARE.
18 *
19 * raconvert - ascii to binary data record conversion
20 *
21 * Author: Carter Bullard [email protected]
22 */
23
24 Tue 16 Jun 10:37:53 EDT 2020
25 Add support for zeek conversions ala the ARGUS_AFLOW record type ...
26 Add conversion map to be provided with the '-f' option.
27 Create conversion for zeek json data.
28
29
30 Wed Oct 10 16:45:56 EDT 2018
31
32 raconvert.1 will convert an ascii flow record file/stream into binary record format.
33 raconvert.1 will uncompress files that have been compressed using gzip or bzip2.
34 The filename extensions for compression must be in the filename for this to happen.
35
36 The file/stream should be created using ra* style programs, with a field delimiter,
37 such as ',' (CSV).
38
39 ra -r file -c, > file.txt
40
41 This invocation generates a file with column names as the first line and data on
42 each subsequent line. The ra* programs, when the -c option is used, will not
43 truncate field values, such as IP addresses and port names. Raconvert.1 cannot
44 process fields that have been truncated due to column width restrictions, and
45 will fail if a column has a '*' at the end.
46
47 The trick to raconvert.1, is that the first line must have the column titles.
48 raconvert.1 will parse the column titles and expect those values in the subsequent
49 data strings that follow. Order does not matter, other than when columns are
50 duplicated, the resulting argus record value will be the last column encountered
51 in the input string.
52
53 raconvert.1 discovers the delimiting character in the file, so prior knowledge
54 of a files content is not necessary.
55
56 StartTime,Flgs,Proto,SrcAddr,Sport,Dir,DstAddr,Dport,SrcPkts,DstPkts,SrcBytes,DstBytes,State
57 2011/11/17.00:23:43.564228, e ,udp,192.168.0.2,mdns, ->,224.0.0.251,mdns,66,0,21070,0,INT
58 2011/11/17.00:09:34.852007, e ,udp,192.168.0.32,mdns, ->,224.0.0.251,mdns,608,0,122367,0,INT
59 2011/11/17.00:00:04.056957, e ,udp,192.168.0.33,tivoconnect, ->,192.168.0.255,tivoconnect,861,0,169617,0,INT
60 2011/11/17.00:00:05.315724, e ,udp,192.168.0.33,mdns, ->,224.0.0.251,mdns,1363,0,258586,0,INT
61 2011/11/17.00:23:43.707389, e ,udp,192.168.0.34,mdns, ->,224.0.0.251,mdns,68,0,23802,0,INT
62 2011/11/17.00:00:03.435544, e ,udp,192.168.0.66,ipp, ->,192.168.0.255,ipp,1680,0,369600,0,REQ
63 2011/11/17.00:02:00.990029, e ,udp,192.168.0.66,netbios-ns, ->,192.168.0.255,netbios-ns,303,0,29088,0,INT
64 2011/11/17.00:03:36.440374, e ,udp,192.168.0.66,mdns, ->,224.0.0.251,mdns,128,0,25253,0,INT
65 2011/11/17.00:00:02.010673, e r ,tcp,192.168.0.68,49157, ->,192.168.0.70,monitor,312617,314397,20632741,123271363,CON
66
67
68 raconvert() will convert the protocol and port names it encounters,into protocol and port numbers, if possible,
69 using its local machines /etc/services file. If a conversion cannot be done, raconvert.1 will fail.
70
71