[synackd]

Description

Document smd iface add and smd iface delete in ochami-smd(1), including positional and payload input forms, options, and delete ID validation. Carry forward the documentation from #217.

Accept multiple network,IPv4 arguments in iface add to match its existing help and examples. Reject malformed pairs with a usage error instead of panicking, and validate all pairs before sending a request. Add regression tests for the complete multi-address request and invalid input using the conventions from test/organize.

Fixes #206
Supersedes #217

Checklist

• My code follows the style guidelines of this project
• I have added/updated comments where needed
• I have added tests that prove my fix is effective or my feature works
• I have run make test (or equivalent) locally and all tests pass
• I have updated the relevant documentation (CLI examples, man pages, README, other docs, etc.)
• DCO Sign-off: All commits are signed off (git commit -s) with my real name and email
• REUSE Compliance:
  • Each new/modified source file has SPDX copyright and license headers
  • Any non-commentable files include a <filename>.license sidecar (not applicable; none added or modified)
  • All referenced licenses are present in the LICENSES/ directory

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation update
• Dependency update
• Build system/CI

---

• I agree to follow the Code of Conduct.

[davidallendj]

I don't think this is directly related to this PR, but I noticed that the config is checked before input validation. For example, if I intentionally run the following command to produce an error:

ochami smd --ignore-config iface add node de:ca:fc:0f:fe:ee external

I believe external should be something like external,10.1.0.55 including an IP address, but this returns a configuration error instead of one related to the input.

2026-10-29T14:33:55-06:00 ERR root.go:247 > failed to execute command error="failed to get base URI for SMD: could not get smd base URI: base URI for smd not found (neither cluster.uri nor smd.uri specified)"
2026-10-29T14:33:55-06:00 ERR cli.go:59 > see 'ochami smd iface add --help' for long command help
exit status 3

However, if you include the --url flag here, it does the input validation first, and returns a more appropriate error.

ochami smd --ignore-config iface add --uri http://127.0.0.1:18080 --no-token node de:ca:fc:0f:fe:ee external

And here's the corresponding error message:

2026-10-29T14:37:28-06:00 ERR root.go:247 > failed to execute command error="invalid network,ip pair \"external\": expected a network name and IPv4 address separated by a comma"
2026-10-29T14:37:28-06:00 ERR cli.go:59 > see 'ochami smd iface add --help' for long command help
exit status 2

If I'm including the --ignore-config flag, it would seem more logical to me to do the input validation before checking the configuration here, but I don't know if the order was set that way intentionally.

[synackd]

However, if you include the --url flag here, it does the input validation first, and returns a more appropriate error.

This is intentional. If you pass --ignore-config, ochami completely ignores the config file and thus has no cluster configuration read in, which has to be passed via e.g. --uri. It doesn't make sense to do any cluster operation without a way to reach OpenCHAMI services.

[davidallendj]

LGTM