143 lines
4.3 KiB
Markdown
143 lines
4.3 KiB
Markdown
Main Command: iottb
|
|
Testbed [I]
|
|
Usage: [OPTIONS] COMMAND [ARGS]...
|
|
|
|
Options:
|
|
-v, --verbosity Set verbosity [0<=x<=3]
|
|
-d, --debug Enable debug mode
|
|
--dry-run
|
|
--cfg-file PATH Path to iottb config file
|
|
--help Show this message and exit.
|
|
|
|
Commands:
|
|
add-device Add a device to a database
|
|
init-db
|
|
rm-cfg Removes the cfg file from the filesystem.
|
|
rm-dbs Removes ALL(!) databases from the filesystem if...
|
|
set-key-in-table-to Edit config or metadata files.
|
|
show-all Show everything: configuration, databases, and...
|
|
show-cfg Show the current configuration context
|
|
sniff Sniff packets with tcpdump
|
|
|
|
|
|
Command: init-db
|
|
Usage: [OPTIONS]
|
|
|
|
Options:
|
|
-d, --dest PATH Location to put (new) iottb database
|
|
-n, --name TEXT Name of new database.
|
|
--update-default / --no-update-default
|
|
If new db should be set as the new default
|
|
--help Show this message and exit.
|
|
|
|
|
|
Command: rm-cfg
|
|
Usage: [OPTIONS]
|
|
|
|
Removes the cfg file from the filesystem.
|
|
|
|
This is mostly a utility during development. Once non-standard database
|
|
locations are implemented, deleting this would lead to iottb not being able
|
|
to find them anymore.
|
|
|
|
Options:
|
|
--yes Confirm the action without prompting.
|
|
--help Show this message and exit.
|
|
|
|
|
|
Command: set-key-in-table-to
|
|
Usage: [OPTIONS]
|
|
|
|
Edit config or metadata files. TODO: Implement
|
|
|
|
Options:
|
|
--file TEXT
|
|
--table TEXT
|
|
--key TEXT
|
|
--value TEXT
|
|
--help Show this message and exit.
|
|
|
|
|
|
Command: rm-dbs
|
|
Usage: [OPTIONS]
|
|
|
|
Removes ALL(!) databases from the filesystem if they're empty.
|
|
|
|
Development utility currently unfit for use.
|
|
|
|
Options:
|
|
--yes Confirm the action without prompting.
|
|
--help Show this message and exit.
|
|
|
|
|
|
Command: add-device
|
|
Usage: [OPTIONS]
|
|
|
|
Add a device to a database
|
|
|
|
Options:
|
|
--dev, --device-name TEXT The name of the device to be added. If this
|
|
string contains spaces or other special
|
|
characters normalization is
|
|
performed to derive a canonical name [required]
|
|
--db, --database DIRECTORY Database in which to add this device. If not
|
|
specified use default from config. [env var:
|
|
IOTTB_DB]
|
|
--guided Add device interactively [env var:
|
|
IOTTB_GUIDED_ADD]
|
|
--help Show this message and exit.
|
|
|
|
|
|
Command: show-cfg
|
|
Usage: [OPTIONS]
|
|
|
|
Show the current configuration context
|
|
|
|
Options:
|
|
--cfg-file PATH Path to the config file
|
|
-pp Pretty Print
|
|
--help Show this message and exit.
|
|
|
|
|
|
Command: sniff
|
|
Usage: [OPTIONS] [TCPDUMP-ARGS] [DEVICE]
|
|
|
|
Sniff packets with tcpdump
|
|
|
|
Options:
|
|
Testbed sources:
|
|
--db, --database TEXT Database of device. Only needed if not current
|
|
default. [env var: IOTTB_DB]
|
|
--app TEXT Companion app being used during capture
|
|
Runtime behaviour:
|
|
--unsafe Disable checks for otherwise required options.
|
|
[env var: IOTTB_UNSAFE]
|
|
--guided [env var: IOTTB_GUIDED]
|
|
--pre PATH Script to be executed before main commandis
|
|
started.
|
|
Tcpdump options:
|
|
-i, --interface TEXT Network interface to capture on.If not specified
|
|
tcpdump tries to find and appropriate one. [env
|
|
var: IOTTB_CAPTURE_INTERFACE]
|
|
-a, --address TEXT IP or MAC address to filter packets by. [env var:
|
|
IOTTB_CAPTURE_ADDRESS]
|
|
-I, --monitor-mode Put interface into monitor mode.
|
|
--ff TEXT tcpdump filter as string or file path. [env var:
|
|
IOTTB_CAPTURE_FILTER]
|
|
-#, --print-pacno Print packet number at beginning of line. True by
|
|
default.
|
|
-e, --print-ll Print link layer headers. True by default.
|
|
-c, --count INTEGER Number of packets to capture.
|
|
--help Show this message and exit.
|
|
|
|
|
|
Command: show-all
|
|
Usage: [OPTIONS]
|
|
|
|
Show everything: configuration, databases, and device metadata
|
|
|
|
Options:
|
|
--help Show this message and exit.
|
|
|
|
|