IOTO(1)                          User Commands                         IOTO(1)

NAME
       ioto- Embedded Device Agent

SYNOPSIS

       ioto-APP [options]

       ioto-APP
           --background
           --config dir
           --count Number
           --debug
           --exit event|minutes
           --gen
           --home directory
           --id UCI
           --ioto path
           --nosave
           --profile profile
           --reset
           --show [bhBH]
           --state dir
           --test suite
           --timeouts
           --trace file[:type:from]
           --verbose
           --version

DESCRIPTION

       Ioto is a compact device agent that includes an MQTT client, HTTP web
       server, HTTP client, embedded database and JSON parser. It can run
       stand-alone as a device agent or the Ioto library can be embedded in
       applications.

       The Ioto web server supports HTTP/1.0, HTTP/1.1, TLS, user
       authentication, sessions, chunked transfers, file upload, and security
       limits.

       Ioto normally reads a set of JSON configuration files. It reads the
       ioto.json5 file for general configuration and the web.json5 for web
       server configuration.

       Ioto can trace activities to a file that defaults to 'stdout'. This can
       be modified via the --trace command line option.

       The --trace option specifies a destination file for trace messages.
       This will override the trace property in the Ioto ioto.json5 file. The
       trace argument syntax is fileName[:types:sources].

       The types are a comma separated list of message types. Valid types
       include: info, debug, error, and trace.  Sources are the code module
       names originating the trace messages.

       You can use "all" for types and sources to match all types/sources. You
       can also use "!type" and "!source" to negate a type or source.

       Ioto responds to the SIGUSR2 signal and increases the trace level.

OPTIONS

       --background
              Run Ioto in the background and detach from the console.

       --config dir
              Override the directory containing config files.

       --count Number
              Override the number of test iterations.

       --debug
              Enable debug tracing. (Shortcut -d).

       --exit event|minutes
              Exit Ioto when the given event is triggered or when the
              specified number of minutes have elapsed. Useful when performing
              limited tests.

       --gen  Generate a UID

       --home directory
              Change to the specified directory before running Ioto.

       --id UCI
              Override the id property in the device.json5 configuration file.
              The id property should be set to the unique device ID.

       --ioto path
              Override the path to the ioto.json5 configuration file.

       --nosave
              Run in-memory and do not save state.

       --profile profile
              Override the operational profile. Defaults to "prod".

       --quiet
              Don't show web server HTTP headers. Alias for --show "".

       --reset
              Reset Ioto state to factory defaults. This erases database state
              under the ./state directory.

       --show [hbHB]
              Show request headers/body (HB) and resposne headers/body (hb).

       --state dir
              Override the directory where state is persisted.

       --test suite
              Run the select test described in the config/test.json5 test
              configuration file.

       --timeouts
              Run Ioto in debug mode and disable all timeouts. This disables
              request and session timeouts.

       --trace file[:types[:sources]]
              Name the Ioto trace file. The types are a comma separated list
              of message types. Valid types include: info, debug, error, and
              trace. Sources are the code module names originating the trace
              messages. You can use "all" for types and sources to match all
              types/sources. You can also use "!type" and "!source" to negate
              a type or source.

       --verbose
              Run with more verbose tracing. (Shortcut -v)

       --version
              Output the product version number.

FILES
       /etc/ioto
       /var/www/ioto
       /usr/local/lib/ioto

REPORTING BUGS

       Report bugs to dev@embedthis.com.

COPYRIGHT

       Copyright (c) Embedthis Software.

ioto                               June 2022                           IOTO(1)