CERT/CC
background
background
CERT NetSA Security Suite 
Open Source Tools for Network Monitoring 
News | Downloads | Documentation | Wiki | Tooltips
SiLK 2.1.0 | YAF 1.0.0.2 | IPA 0.4.0 | fixbuf 0.8.0 | Portal 0.9.0 | RAVE 1.9.16 | iSiLK 0.1.6
IPA - Documentation
Documentation | Downloads | Release Notes


NAME

ipaexport - Export textual data from an IPA data store


SYNOPSIS

  ipaexport --catalog CATALOG_NAME
        [--db=DB_URI] [--time=TIME] [--delimiter=DELIM] OUTPUT_FILE


DESCRIPTION

ipaexport exports IPA datasets to text files.


OPTIONS

--catalog=CATALOG_NAME

Specifies the name of the IPA catalog to export.

--time=TIME

This argument allows you to export a dataset that was active at TIME. The expected format of this option is YYYY/MM/DD[:HH[:MM[:SS]]]. If this option is specified, a dataset will only be returned if TIME falls between the start and end time for the dataset. If this option is not specified, the "no time" dataset for that catalog will be returned, if present.

--db=DB_URI

A URI specifying the IPA data store to connect to. Due to the possible exposure of database credentials via process listings, the use of this option is discouraged. See ENVIRONMENT below for the recommended way of specifying the IPA data store URI.

--delimiter=DELIM

Specifies the character used as a field delimiter in the output file. By default, ipaimport uses whitespace as the field delimiter.


EXAMPLES

To export the "countrycodes" prefix map:

  $ ipaexport --catalog countrycodes --time 2007/04/03 countrycodes.txt

To export the "flowcount" Bag with pipe-delimited fields:

  $ ipaexport --catalog flowcount --delimiter \| flowcount.txt

To export the "badhosts" IP set from April 3, 2007:

  $ ipaexport --catalog badhosts --time 2007/04/03 badhosts.20070403.txt


ENVIRONMENT

IPA_DB_URI

A URI specifying the location of (and credentials for) the IPA data store. The format of this URI is driver://user:password@hostname/database, e.g.:

    postgresql://ipauser:secret@database-server.domain.com/ipa


NOTES

Currently, only the PostgreSQL database driver is supported.


SEE ALSO

ipaimport(1), ipaquery(1)