dmfs - reads observations from file or named pipe
dmfs --help
dmfs --version
dmfs --config file [--name name] [--node id] [--sensor id] [--logger name] [--format format] [--output file] [--debug] [--verbose]
The dmfs program reads observations from file system, virtual file, or named pipe. The program can be used to read sensor values from the 1-Wire File System (OWFS).
All requests of an observation have to contain the path of the file to be read
in attribute request. Response values are extracted by group from the raw
response using the given regular expression pattern. For each group to extract,
a response with the name of the respective group has to be added to the
request.
If any receivers are specified, observations are forwarded to the next receiver
via POSIX message queue. The program can act as a sole data logger if output and
format are set. If the output path is set to -, observations are printed to
stdout.
A configuration file is required to configure the jobs to perform. Each observation must have a valid target id. The database must contain the node, the sensor, and the target.
- --config, -c file
-
File path to the configuration file.
- --debug, -D
-
Forward logs messages of level
LL_DEBUGvia IPC (if logger is set). - --format, -f [csv|jsonl]
-
Output format of observations if
--outputis set. Either CSV or JSON Lines. - --help, -h
-
Output available command-line arguments and quit.
- --logger, -l name
-
Name of logger. If set, sends logs to dmlogger(1) process of given name.
- --name, -n name
-
Name of program instance and configuration (default is
dmfs). - --node, -N id
-
Node id.
- --output, -o file
-
Output file to append observations to (
-for stdout). - --sensor, -S id
-
Sensor id.
- --verbose, -V
-
Print log messages to stderr.
- --version, -v
-
Output version information and quit.
Read the jobs to perform from configuration file and execute them sequentially:
$ dmfs --name dmfs --config /usr/local/etc/dmpack/dmfs.conf --verbose
Project web site: https://www.dabamos.de/