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 format.  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 discovered 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 encountered.

       raconvert.1 can read gzip and bzip2 compressed files, based on the file extension.

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)