diff options
author | Saya Sugiura <ssugiura@jp.adit-jv.com> | 2020-12-21 11:40:42 +0900 |
---|---|---|
committer | Saya Sugiura <39760799+ssugiura@users.noreply.github.com> | 2021-01-06 09:27:28 +0900 |
commit | 4c925c1797268a64f5007740019fd852e70d24e6 (patch) | |
tree | 4524bcb3e6342cde44e5d7748b7790201ee4ead3 /doc | |
parent | 929a02f18556b9f1109c84d784a56de1e36a6e41 (diff) | |
download | DLT-daemon-4c925c1797268a64f5007740019fd852e70d24e6.tar.gz |
doc: Limitation to SIGUSR1 usage on Android
Signed-off-by: Saya Sugiura <ssugiura@jp.adit-jv.com>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/dlt_design_specification.md | 7 | ||||
-rw-r--r-- | doc/dlt_for_developers.md | 5 |
2 files changed, 12 insertions, 0 deletions
diff --git a/doc/dlt_design_specification.md b/doc/dlt_design_specification.md index a6df3c5..b5f8cc7 100644 --- a/doc/dlt_design_specification.md +++ b/doc/dlt_design_specification.md @@ -350,6 +350,13 @@ steps are executed: - Store service id in callback table - Store function pointer in callback table +#### Android: Thread termination + +On Android, `pthread_cancel` is not available in bionic. So current +implementation uses *SIGUSR1* and `pthread_kill` to terminate housekeeper +thread. Due to this, application which is linked to DLT library should not +define *SIGUSR1*. + ### Communication between DLT daemon and DLT user library The communication mechanism (IPC) used between DLT daemon and DLT user library diff --git a/doc/dlt_for_developers.md b/doc/dlt_for_developers.md index 931397c..781f6fb 100644 --- a/doc/dlt_for_developers.md +++ b/doc/dlt_for_developers.md @@ -81,6 +81,11 @@ and to TARGET\_LINK\_LIBRARIES: ${DLT_LIBRARIES} ``` +### Limitation + +On Android, definition of `SIGUSR1` in DLT application shall be avoided since +DLT library blocks `SIGUSR1` to terminate housekeeper thread at exit. + ## General Rules for Logging ### Be Smart |