Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
RACONVERT(1)		     General Commands Manual		    RACONVERT(1)

NAME
     raconvert - convert comma-separated ASCII argus(8) data, to binary argus(8)
     data.

SYNOPSIS
     raconvert -r input -w output

DESCRIPTION
     Raconvert	reads  ASCII  based files, either CSV, or Json argus data from a
     file or stdin, and converts the ASCII representation to binary  argus  for-
     mat.  In order for raconvert to process the data correctly, the file should
     be  created  by ra.1 like programs, using the "-c <char>" option or the "-M
     json" mode, to specify the ASCII format.  In the case of CSV files,  column
     delimiters  can  be any non-ambiguous character, and are automatically dis-
     covered from the files title string.

     In the case of CSV files,	because  raconvert.1  expects  the  first  valid
     string  in  the  file to be a ra.1 column title line, the ra.1 program must
     use the equivalent of the "-L 0" option.

     The file can present its column oriented data in any order,  and  raconvert
     will  accomodate.	 Duplicate columns on the same line are allowed, but the
     final value in the resulting argus record with be the  last  value  encoun-
     tered.

     raconvert.1 can read gzip and bzip2 compressed files, based on the file ex-
     tension.

USES
     Raconvert is predominately used for reading ASCII represented archive data.
     Argus  data  is  routinely converted to ASCII for inspection and archiving,
     due to the good compressibility offered by gzip and others.  Argus data  is
     also  converted  from  binary  to	ASCII  and  back to binary, as a routine
     process to enforce content policies.  The conversion, with ASCII inspection
     ensures that specific data of interest isn't leaked.

INVOCATION
     ra -L0 -c , -r argusfile > argus.ascii.csv
     raconvert -r argus.ascii.csv -w argusfile

     ra -M json -r argusfile > argus.json
     raconvert -r argus.json -w argusfile

COPYRIGHT
     Copyright (c) 2000-2024 QoSient. All rights reserved.

SEE ALSO
     ra(1), rarc(5), argus(8),

FILES
AUTHORS
     Carter Bullard (carter@qosient.com).

BUGS
raconvert 5.0.3 		 07 October 2023		    RACONVERT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=raconvert&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help