Skip to content

Commit fc65e6b

Browse files
authored
Expand ROS Specific Namespace Prefix for Actions
To better secure and segment access control of the different ROS subsystems, specifically to avoid the mapping of ROS2 actions to DDS topics from colliding with those of ROS2 topics and services, actions are to be allocated their own prefix to facilitate simpler policy profile permissions. Additionally, this and helps to prevent crossover of information flow in the case of more general permission prefix expressions. Contex: #193 (comment)
1 parent 97d5812 commit fc65e6b

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

articles/140_topic_and_service_name_mapping.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -210,8 +210,8 @@ In order to differentiate ROS topics easily, all DDS topics created by ROS shall
210210
For example, a plain topic called `/foo` would translate to a DDS topic `rt/foo`, which is the result of implicitly adding `rt` to the namespace of a ROS topic which is in the root namespace `/` and has a base name `foo`.
211211
As another example, a topic called `/left/image_raw` would translate to a DDS topic `rt/left/image_raw`, which is the result of implicitly adding `rt` to the namespace of a ROS topic which is in the namespace `/left` and has a base name `image_raw`.
212212

213-
For systems where Services are implemented with topics (like with OpenSplice), a different subsystem character can be used: `rq` for the request topic and `rr` for the response topic.
214-
On systems where Services are handled explicitly implemented, we consider a separate prefix, e.g. `rs`.
213+
For systems where Services are implemented with topics (like with OpenSplice), a different subsystem character can be used: `rq` and `raq` for the request topic, `rr` and `rar` for the response topic.
214+
On systems where Services are handled explicitly implemented, we consider a separate prefix, e.g. `rs` and `ras`.
215215

216216
Here is a non-exhaustive list of prefixes:
217217

@@ -222,7 +222,10 @@ Here is a non-exhaustive list of prefixes:
222222
| ROS Service Response | rr |
223223
| ROS Service | rs |
224224
| ROS Parameter | rp |
225-
| ROS Action | ra |
225+
| ROS Action Topics | rat |
226+
| ROS Action Service Request | raq |
227+
| ROS Action Service Response | rar |
228+
| ROS Action Service | ras |
226229

227230
While all planned prefixes consist of two characters, i.e. `rX`, anything proceeding the first namespace separator, i.e. `/`, can be considered part of the prefix.
228231
The standard reserves the right to use up to 8 characters for the prefix in case additional prefix space is needed in the future.

0 commit comments

Comments
 (0)