DCMDFIND(1)

NAME
dcmdfind - search for dives

SYNOPSIS
dcmdfind [-v] [-l limit] [file ...]

DESCRIPTION
The dcmdfind utility searches for dives in dcmd(1) files. Its arguments are as follows:

-l limit
    Limit which dives are emitted. See Limits for details.

-v  Emit warnings during parse. Specify twice for further debugging information.

If there are multiple dive computers specified, or multiple divers, the first is selected to represent all output dives.

All dives are merged into a single divelog, so dives must have the same dive computer as the first (by date), else they are omitted. Duplicate fingerprints are also omitted.

dcmdfind produces output on standard output as documented in dcmd(1).

  Limits
Processed dives may be limited with the -l limit option consisting of key=value limit pairs. The keys may be as follows:

dafter=date
    Dives starting after (inclusive) the date.

dbefore=date
    Dives starting before (inclusive) the date.

date=date
    Dives starting on the date.

dive=pid
    The dive as described by its dcmdls(1) parse identifier.

mode=free|open|closed|gauge
    Dives matching the mode.

dtafter=datetime
    Dives starting after (inclusive) the datetime.

dtbefore=datetime
    Dives starting before (inclusive) the datetime.

Dates are always formatted as YYYY-mm-dd. The special dates "today" and "yesterday" refer to the current date and day before, respectively. Date-times are formatted as YYYY-mm-ddTHH:MM.

EXIT STATUS

EXAMPLES
To list only the current date's dives:

    dcmdfind -ldate=today *.xml | dcmdls

To graph today's open-circuit dive:

    dcmdfind -ldate=today -lmode=open *.xml | dcmdterm

SEE ALSO
dcmd(1)

AUTHORS
The dcmdfind utility was written by Kristaps Dzonsons, kristaps@bsd.lv.

BUGS
Some data (e.g., vendor events) are ignored during conversion. These are reported to standard error.