dcmdfind —
search for dives
dcmdfind |
[ -v
]
[-l
limit
]
[file ... ] |
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).
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.