docs: Adds DR-002 for DLT network transport by rmaddikery · Pull Request #299 · eclipse-score/logging

rmaddikery · 2026-09-04T07:17:52Z

Rendered page: https://eclipse-score.github.io/logging/pr-299/features/logging/architecture/DR-002-dlt-network-transport.html

GTL adpotion
DLTv2 support (for ipv4 fragmentation)
DLT header construction/transmission into a dedicated network-stack module

Notes for Reviewer

Pre-Review Checklist for the PR Author

PR title is short, expressive and meaningful
Commits are properly organized
Relevant issues are linked in the References section
Tests are conducted
Unit tests are added

Checklist for the PR Reviewer

Commits are properly organized and messages are according to the guideline
Unit tests have been written for new behavior
Public API is documented
PR title describes the changes

Post-review Checklist for the PR Author

All open points are addressed and tracked via issues

References

Closes #

github-actions · 2026-09-04T07:18:53Z

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run --lockfile_mode=error //:license-check

Status: ⚠️ Needs Review

Click to expand output

[License Check Output]
Extracting Bazel installation...
Starting local Bazel server (8.6.0) and connecting to it...
INFO: Invocation ID: 8ffef29b-c0db-4e81-9cb4-a6a617eb2973
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Loading: 
Loading: 4 packages loaded
WARNING: Target pattern parsing failed.
ERROR: Skipping '//:license-check': no such target '//:license-check': target 'license-check' not declared in package '' defined by /home/runner/work/logging/logging/BUILD
ERROR: no such target '//:license-check': target 'license-check' not declared in package '' defined by /home/runner/work/logging/logging/BUILD
INFO: Elapsed time: 16.445s
INFO: 0 processes.
ERROR: Build did NOT complete successfully
ERROR: Build failed. Not running target

github-actions · 2026-09-04T07:32:06Z

The created documentation from the pull request is available at: docu-html

pawelrutkaq · 2026-09-07T06:27:28Z

Few questions

so its about LSM logging module for iosock in QNX ?
What is te GTL standing for ? (Generic trac lib from baselibs ?)
What IPC will be used in a way into LSM (especially knowing LSM have specific requirements, like You cannot use malloc so ie "standard" C++ containers will not work etc)?
Document mentions trace but the mw::log does not have "standard" trace API, will this be added or mean something else ?

MaciejKaszynski · 2026-09-04T15:17:13Z

+     network stack, shared with all other networked services.
+
+   A second, feature-flagged client backend (`shm_dma_enabled`)
+   would allow forwarding of records through a GTL client into a


I think it would be nice to add all the acronyms to a glossary.

Added in the puml file

MaciejKaszynski · 2026-09-07T06:38:19Z

+' SPDX-License-Identifier: Apache-2.0
+' *******************************************************************************
+
+@startuml network_stack_plugin


I think the diagram and text don't make the plugin approach clear, do you think we could add a dummy block for the datarouter to make this clear?

MaciejKaszynski · 2026-09-07T06:40:07Z

+gtl -r-> shmpayload
+gtl -r-> shmmeta
+gtl -r-> shmctrl
+mwlog -r-> ctrlchannel


Is this a signal that there is messages in the shared memory? Might be good to label the edge to make this clear

The shm is the interface. Each interface is clearly as R/O OR R/W. The purpose of the ctrl channel is to co-ordinate the R/W of the records through the other interface.

three separate interfaces: metadata, payload and control

MaciejKaszynski · 2026-09-07T07:02:51Z

+interface "shm\n(control block)" as shmctrl
+interface "DLT QNX\nControl Channel" as ctrlchannel
+
+gtl -r-> shmpayload


We would later define a format for these log messages, is that right?

pawelrutkaq · 2026-09-08T09:26:25Z

Few questions

so its about LSM logging module for iosock in QNX ?

What is te GTL standing for ? (Generic trac lib from baselibs ?)

What IPC will be used in a way into LSM (especially knowing LSM have specific requirements, like You cannot use malloc so ie "standard" C++ containers will not work etc)?

Document mentions trace but the mw::log does not have "standard" trace API, will this be added or mean something else ?

After meeting:

Yes
Yes
IPC using basics from baselibs/com fitting restriction of LSM: like no malloc
GTL will be used as mw::log backend @rmaddikery will correct image
mw::diag wll provide dynamic configuration at runtime; it's not known yet who will implement diag callouts, since they probably cannot be implemented in LSM due to limitations in LSM.

- GTL adpotion - DLTv2 seam support - DLT header construction/transmission into a dedicated network-stack module

- Adds dlt wire format selection seam - Shows how log records are forwarded to GTL backend via GTL - Fix mw::diag interface and shows an independant component translating diag commands via DLT qnx control channel - Added legend

pawelrutkaq · 2026-09-09T06:15:17Z

looks better now!

github-project-automation Bot added this to LOG - Logging FT Sep 4, 2026

github-project-automation Bot moved this to Backlog in LOG - Logging FT Sep 4, 2026

rmaddikery had a problem deploying to workflow-approval September 4, 2026 07:17 — with GitHub Actions Failure

rmaddikery force-pushed the rama_adds_dr_002 branch from ab3966a to 3519466 Compare September 4, 2026 07:18

rmaddikery deployed to workflow-approval September 4, 2026 07:18 — with GitHub Actions Active

rmaddikery changed the title ~~docs: Adds DR-002 decision record for DLT network transport~~ docs: Adds DR-002 for DLT network transport Sep 4, 2026

rmaddikery had a problem deploying to workflow-approval September 4, 2026 07:54 — with GitHub Actions Failure

rmaddikery force-pushed the rama_adds_dr_002 branch from dc0d587 to d251993 Compare September 4, 2026 08:01

rmaddikery deployed to workflow-approval September 4, 2026 08:01 — with GitHub Actions Active

rmaddikery force-pushed the rama_adds_dr_002 branch from d251993 to 65152c0 Compare September 4, 2026 08:38

rmaddikery had a problem deploying to workflow-approval September 4, 2026 08:38 — with GitHub Actions Failure

rmaddikery force-pushed the rama_adds_dr_002 branch from 65152c0 to c98d612 Compare September 4, 2026 09:22

rmaddikery deployed to workflow-approval September 4, 2026 09:22 — with GitHub Actions Active

rmaddikery force-pushed the rama_adds_dr_002 branch from c98d612 to 0953825 Compare September 4, 2026 13:04

rmaddikery deployed to workflow-approval September 4, 2026 13:04 — with GitHub Actions Active

rmaddikery marked this pull request as ready for review September 4, 2026 13:08

rmaddikery requested review from antonkri, arsibo and pawelrutkaq as code owners September 4, 2026 13:08

MaciejKaszynski reviewed Sep 7, 2026

View reviewed changes

rmaddikery force-pushed the rama_adds_dr_002 branch from 0953825 to c050285 Compare September 8, 2026 14:21

rmaddikery had a problem deploying to workflow-approval September 8, 2026 14:21 — with GitHub Actions Failure

rmaddikery added 2 commits September 8, 2026 16:27

docs: Adds DR-002 for DLT network transport

6d45379

- GTL adpotion - DLTv2 seam support - DLT header construction/transmission into a dedicated network-stack module

docs: Adds puml diagram for dr-002

db51c17

rmaddikery force-pushed the rama_adds_dr_002 branch from c050285 to bf13827 Compare September 8, 2026 14:27

rmaddikery had a problem deploying to workflow-approval September 8, 2026 14:27 — with GitHub Actions Failure

rmaddikery force-pushed the rama_adds_dr_002 branch from bf13827 to 6750b80 Compare September 8, 2026 15:26

rmaddikery deployed to workflow-approval September 8, 2026 15:26 — with GitHub Actions Active

rmaddikery had a problem deploying to workflow-approval September 8, 2026 15:46 — with GitHub Actions Failure

Rename DR-002-dlt-network-transport puml as dlt_plugin

a0fdb73

rmaddikery force-pushed the rama_adds_dr_002 branch from bb5739e to a0fdb73 Compare September 8, 2026 15:47

rmaddikery deployed to workflow-approval September 8, 2026 15:47 — with GitHub Actions Active

pawelrutkaq approved these changes Sep 10, 2026

View reviewed changes

github-project-automation Bot moved this from Backlog to On Hold in LOG - Logging FT Sep 10, 2026

rmaddikery merged commit 2745e3c into main Sep 11, 2026
27 of 28 checks passed

rmaddikery deleted the rama_adds_dr_002 branch September 11, 2026 07:35

github-project-automation Bot moved this from On Hold to Done in LOG - Logging FT Sep 11, 2026

Conversation

rmaddikery commented Sep 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Notes for Reviewer

Pre-Review Checklist for the PR Author

Checklist for the PR Reviewer

Post-review Checklist for the PR Author

References

Uh oh!

github-actions Bot commented Sep 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

License Check Results

Uh oh!

github-actions Bot commented Sep 4, 2026

Uh oh!

pawelrutkaq commented Sep 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MaciejKaszynski Sep 4, 2026

Choose a reason for hiding this comment

Uh oh!

rmaddikery Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

MaciejKaszynski Sep 7, 2026

Choose a reason for hiding this comment

Uh oh!

MaciejKaszynski Sep 7, 2026

Choose a reason for hiding this comment

Uh oh!

rmaddikery Sep 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rmaddikery Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

MaciejKaszynski Sep 7, 2026

Choose a reason for hiding this comment

Uh oh!

rmaddikery Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

pawelrutkaq commented Sep 8, 2026

Uh oh!

pawelrutkaq commented Sep 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

rmaddikery commented Sep 4, 2026 •

edited

Loading

github-actions Bot commented Sep 4, 2026 •

edited

Loading

pawelrutkaq commented Sep 7, 2026 •

edited

Loading

rmaddikery Sep 8, 2026 •

edited

Loading

pawelrutkaq commented Sep 9, 2026 •

edited

Loading