DCMDFIND(1) General Commands Manual DCMDFIND(1)

NAME

dcmdfindsearch 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

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

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.
August 13, 2018 OpenBSD 6.3