SolarCapture C Bindings User Guide  SF-115721-CD
Draft 2A
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
sc_timestamp_filter Node Reference

Filter packets, accepting only those in a given range of timestamps.

Detailed Description

The range can be specified either as a start and end timestamp given in seconds since 1970, or as a time range given as a string.

Arguments

Argument Optional? Default Type Description
start_time Yes -1.0 SC_PARAM_DBL Start of time range to accept (seconds since 1970).
end_time Yes -1.0 SC_PARAM_DBL End of time range to accept (seconds since 1970).
range Yes NULL SC_PARAM_STR Time range over which packets are accepted.

The range argugment takes the form START-END, where either START or END may be omitted. START and END should take one of the following forms:

Format Description
X.Y[smh] Time in seconds since first packet in input file
+X.Y[smh] Time in seconds since start of time range (END only)
HH:MM:SS Time of day
YYYY/MM/DD HH:MM:SS Absolute time and date

When a time is given without a date, then the date is the date of the start of the range (if given) or otherwise the date of thet first packet in the input.

Exposed Statistics

Statistics exposed by the sc_filter, sc_range_filter and sc_timestamp_filter nodes.

Name Type Data Type Description
pkts_rejected uint64_t pkt_count The number of packets not matched by the filter.