Repository navigation
v0.12.1
Date: 2026-11-12
Previous release: v0.12.0
Container contract 1.5, fixture format 1.0 and every upstream pin are unchanged. A patch release: every gosec v2.30.0 finding in the Go code is fixed in the code, with no exclusions and no #nosec. Standalone gosec -tests ./... per module, before: cbsigma 74, dscsystems 63, own/go-dnp3 85 (on macOS), and 2 more in own/go-dnp3's Linux-only serial code; after: 0 in each module, on macOS and on Linux. gosec findings are fixed in the code. gosec does not run in this repository's public lint or CI (otfabric/engineering policy GO-014, ADR-0011): a maintainer scans on their own machine with make sast REPO=dnp3-interop from otfabric/engineering before each release, and accepted findings are kept in a private repository.
Changed
- own/go-dnp3 builds on go-dnp3 v1.13.0 (from v1.12.0); the adapter's options are unchanged.
Fixed
- Integer conversions (G115): flag, fixture and length values reach the protocol fields through checked conversions (
convert.goin each module) instead of plain conversions. Every value was already bounded by the flag or fixture checks, so no input that worked before fails now; a bound that ever disagreed with a field's width is a usage error (exit 2) for a flag and an invalid fixture (exit 4) for a fixture, instead of a truncated value. A file of more than 4 GiB, which only a master could write, is an error of its size instead of a truncated size (cbsigma: the error of the store; own/go-dnp3: file status FATAL). The control handlers check the 32-bit index of a request against the 16 bits of a fixture index once, before looking the point up; the answers are unchanged. The dscsystems adapter reads the indexes of a start-stop range in 16 bits without wrapping and the 48-bit time of a security statistic directly into an int64; the own image reads a 48-bit attribute time the same way. - Paths (G304, G703):
print-fixtureopens<name>/fixture.jsonin anos.Rootof/fixtures, which the name cannot leave even through a symbolic link;--fixtureis cleaned (filepath.Clean). The dscsystems adapter writes the fixture's files into its served tree through anos.Rootof that tree, and removes the tree when that fails. The Go tests read the repository's fixtures through anos.Rootoffixtures/. - File modes (G301, G306): the readiness file is written with mode 0600 instead of 0644; it is empty and only its existence counts (
test -f, by the image's own user). The tests' temporary files are 0600. The files and directories the dscsystems outstation serves keep 0644 and 0755, now named constants (servedFileMode,servedDirMode): the library reports those bits to the master, and the[files] file-infocheck wantsrw-r--r--. gosec flags a named constant mode inos.WriteFileandos.MkdirAllas well as a lateros.Chmod; it does not check the modes ofos.Root's methods, through which the tree is written. - Unsafe (G103, own/go-dnp3): the serial line's termios ioctl goes through
golang.org/x/sys/unix(IoctlSetTermios, BSD-3-Clause, now in THIRD_PARTY_NOTICES.md) instead ofsyscall.Syscallwith anunsafe.Pointer; the line settings are unchanged.
Docs
- CONTRIBUTING.md: the Go style rule (gosec findings fixed in code, no
#nosec, checked conversions,os.Root). - SECURITY.md: how gosec findings are handled: fixed in code; scanned before each release with
make sast REPO=dnp3-interopfrom otfabric/engineering (ADR-0011), not in public CI (GO-014); accepted findings in a private repository.
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/dnp3-interop-opendnp3:v0.12.1 |
sha256:22d5d0c03d7648af2b059898fb49d2e5dcd5a3e8a722935a5adfd6912bb21655 |
ghcr.io/otfabric/dnp3-interop-dscsystems:v0.12.1 |
sha256:0e524995121752018db491c49bf08a5fde2098a2ce51541cdf1dff0a9b18f1bd |
ghcr.io/otfabric/dnp3-interop-dnp3py:v0.12.1 |
sha256:6be83712526017b0247a90cfd1a36fd679b87abb01b54ff438a52332aaa26469 |
ghcr.io/otfabric/dnp3-interop-cbsigma:v0.12.1 |
sha256:5469a14546b5bc3a5c75fdbffe4b4d8f9dd7113357cfb74daaba8db0c1d998ed |
ghcr.io/otfabric/dnp3-interop-nfmdnp3:v0.12.1 |
sha256:6e7f72f58cc9a59804c6e6fa3ff368593e40bf03596934d642724c96191a2ff2 |
The dnp3c runner (dnp3-interop-dnp3c, the DNP3 IED Certification Procedure as Step Function I/O's dnp3c implements it, GPL-3.0-only) is not published: make image-dnp3c VERSION=v0.12.1 builds it, fetching dnp3c from Maven Central. See docs/CONFORMANCE.md.
Pinning in a consumer
DNP3_INTEROP_OPENDNP3_IMAGE=ghcr.io/otfabric/dnp3-interop-opendnp3@sha256:22d5d0c03d7648af2b059898fb49d2e5dcd5a3e8a722935a5adfd6912bb21655
DNP3_INTEROP_DSCSYSTEMS_IMAGE=ghcr.io/otfabric/dnp3-interop-dscsystems@sha256:0e524995121752018db491c49bf08a5fde2098a2ce51541cdf1dff0a9b18f1bd
DNP3_INTEROP_DNP3PY_IMAGE=ghcr.io/otfabric/dnp3-interop-dnp3py@sha256:6be83712526017b0247a90cfd1a36fd679b87abb01b54ff438a52332aaa26469
DNP3_INTEROP_CBSIGMA_IMAGE=ghcr.io/otfabric/dnp3-interop-cbsigma@sha256:5469a14546b5bc3a5c75fdbffe4b4d8f9dd7113357cfb74daaba8db0c1d998ed
DNP3_INTEROP_NFMDNP3_IMAGE=ghcr.io/otfabric/dnp3-interop-nfmdnp3@sha256:6e7f72f58cc9a59804c6e6fa3ff368593e40bf03596934d642724c96191a2ff2
# built locally (see above), not pulled:
DNP3_INTEROP_DNP3C_IMAGE=ghcr.io/otfabric/dnp3-interop-dnp3c:v0.12.1manifest.json records the upstream revisions these images were built from, and under localOnly the pins of the dnp3c image you build yourself. The published images contain MIT, Apache-2.0 and GPL-3.0-or-later software and are for interoperability testing. See THIRD_PARTY_NOTICES.md.