dcmdls —
list dives
dcmdls |
[ -hmv
]
[-s
sort
]
[file ... ] |
The
dcmdls utility accepts a set of
dcmd(1) files and collects them into an easy list
view. Its arguments are as follows:
-
-
-h- Human-readable time spans: break down time into minutes and seconds
instead of just seconds. This is the default.
-
-
-m- Machine-readable time spans: always seconds.
-
-
-v- Verbose parsing.
-
-
-s
sort- Sort listed output within a divelog. This may be one of
datetime for time (the default),
maxtime for maximum dive time,
rmaxtime for reverse maximum dive time,
maxdepth for maximum depth,
rmaxdepth, for reverse maximum
depth.
Lists are grouped by dive computer and diver and shown as:
divelog: [vendor] [, product] [, model] [: diver]
[pid] [date] [time] [maxdepth] [avgtemp|-] [maxtime] [type]
These fields are as follows:
-
-
vendor- If specified, the dive computer vendor. For example,
“Suunto”.
-
-
product- If specified, the dive computer. For example, “D6i”.
-
-
model- If specified, the model of the dive computer.
-
-
diver- If specified, the diver.
-
-
pid- The parse identifier. This is unique within a series of dives and depends
on input ordering.
-
-
date- The starting date in YYYY-mm-dd format.
-
-
time- The starting time in YYYY-mm-dd format.
-
-
maxdepth- The maximum depth in metres.
-
-
maxtime- The maximum time (dive time) in seconds or as a formatted time if
-h was specified.
-
-
avgtemp- The average temperature or
- if no
temperatures were specified.
-
-
type- The type of dive: “open” for open-circuit,
“free” for free diving, “gauge” for gauge
mode, or “closed” for closed-circuit dives.
The
dcmdls utility exits 0 on success,
and >0 if an error occurs.
dcmd(1)
The
dcmdls utility was written by
Kristaps Dzonsons,
kristaps@bsd.lv.