Scroll to navigation

AIOCOAP-RD(1) aiocoap AIOCOAP-RD(1)

NAME

aiocoap-rd - Resource Directory server

A plain CoAP resource directory according to RFC9176

Known Caveats:

  • It is very permissive. Not only is no security implemented.
  • This may and will make exotic choices about discoverable paths whereever it can (see StandaloneResourceDirectory documentation)
  • Split-horizon is not implemented correctly
  • Unless enforced by security (ie. not so far), endpoint and sector names (ep, d) are not checked for their lengths or other validity.
  • Simple registrations don't cache .well-known/core contents



usage: aiocoap-rd [-h] [--bind BIND] [--credentials CREDENTIALS]

[--tls-server-certificate CRT] [--tls-server-key KEY]
[--version] [--proxy-domain PROXY_DOMAIN] [--lwm2m-compat]
[--no-lwm2m-compat] [--verbose]


NAMED ARGUMENTS

Host and/or port to bind to (see --help-bind for details)
JSON file pointing to credentials for the server's identity/ies.
TLS certificate (chain) to present to connecting clients (in PEM format)
TLS key to load that supports the server certificate
show program's version number and exit
Enable the RD proxy extension. Example: proxy.example.net will produce base URIs like coap://node1.proxy.example.net/. The names must all resolve to an address the RD is bound to.
Compatibility mode for LwM2M clients that can not perform some discovery steps (moving the registration resource to /rd)
Disable all compativility with LwM2M clients that can not perform some discovery steps (not even accepting registrations at /rd with warnings)

Default: True

Increase debug log output (repeat for increased verbosity)

Default: 0


COPYRIGHT

Christian Amsüss and the aiocoap contributors

April 3, 2025 0.4