DCMDFIND(1) General Commands Manual DCMDFIND(1)

dcmdfind
search for dives

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

The dcmdfind utility searches for dives in dcmd(1) files. Its arguments are as follows:
 
 
limit
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:
 
 
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.

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

dcmd(1)

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