Skip to content

Commit be264d7

Browse files
iox-#1295 Rework iceoryx on 32-bit article
1 parent 8d74cc9 commit be264d7

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

doc/website/advanced/iceoryx-on-32-bit.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# Status
1+
# iceoryx on 32 bit architectures
22

33
iceoryx works on 32-bit hardware, but only as technology preview and is not meant for production.
44

5-
See also https://github.com/eclipse-iceoryx/iceoryx/issues/2301 for more details and the limitations sections in this document.
5+
See also [here](https://github.com/eclipse-iceoryx/iceoryx/issues/2301) for more details and the limitations sections in this document.
66

7-
# Dependencies
7+
## Dependencies
88

99
For 32-bit support, the following packages need to be installed on ubuntu
1010

@@ -13,7 +13,7 @@ sudo dpkg --add-architecture i386
1313
sudo apt install libacl1-dev:i386 libc6-dev-i386 libc6-dev-i386-cross libstdc++6-i386-cross gcc-multilib g++-multilib
1414
```
1515

16-
# iceoryx as 32-bit library
16+
## iceoryx as 32-bit library
1717

1818
## Build steps
1919

@@ -42,7 +42,7 @@ Furthermore, it is required for the 32-64 bit mix-mode to enforce the same data
4242
An internal data structure, the `UsedChunkList`, might be left in a corrupt state when an application terminates abnormally when writing to this data structure.
4343
In order to detect torn-writes on 32-bit, the data structure needs to be refactored.
4444

45-
# iceoryx for communication between 32-bit and 64-bit applications aka 32-64 bit mix-mode
45+
## iceoryx for communication between 32-bit and 64-bit applications aka 32-64 bit mix-mode
4646

4747
## Attention
4848

@@ -65,7 +65,7 @@ If the layout differs, it can lead to unpredictable behavior and errors in the a
6565
6666
The simplest way to fix this specific alignment issue, is to use the `-malign-double` flag, which enforces an 8 byte alignment boundary for 64-bit data types on 32-bit architectures.
6767
68-
## Build steps
68+
### Build steps
6969
7070
Similar to the 32-bit build, the simplest way to build for the 32-64 bit mix-mode is the `iceoryx_build_test.sh` script
7171
@@ -102,7 +102,7 @@ build-64/iceoryx_examples/request_response/iox-cpp-request-response-listener-ser
102102
build-32/iceoryx_examples/request_response/iox-cpp-request-response-waitset-client
103103
```
104104

105-
## Limitations
105+
### Limitations
106106

107107
In addition to the limitations of the 32-bit iceoryx, the mix-mode needs to ensure that all the data structures in shared memory have the same layout.
108108
While the `-malign-double` flag can be used for the iceoryx data types, it does not work for POSIX data structures like `sem_t`.

0 commit comments

Comments
 (0)