DCMDFIND(1) General Commands Manual DCMDFIND(1)

search for dives

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

The dcmdfind utility searches for dives in dcmd(1) files. Its arguments are as follows:
Limit which dives are emitted. See Limits for details.
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).

Processed dives may be limited with the -l limit option consisting of key=value limit pairs. The keys may be as follows:
Dives starting after (inclusive) the date.
Dives starting before (inclusive) the date.
Dives starting on the date.
The dive as described by its dcmdls(1) parse identifier.
Dives matching the mode.
Dives starting after (inclusive) the 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.

The dcmdfind utility exits 0 on success, and >0 if an error occurs.

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


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

Some data (e.g., vendor events) are ignored during conversion. These are reported to standard error.
August 13, 2018 OpenBSD 6.3