diff options
| author | Saya Sugiura <ssugiura@jp.adit-jv.com> | 2020-12-21 11:40:42 +0900 |
|---|---|---|
| committer | Saya Sugiura <ssugiura@jp.adit-jv.com> | 2021-01-06 09:19:55 +0900 |
| commit | 1987fa2b75253d9f47cde8f4dd593509027147a5 (patch) | |
| tree | 4524bcb3e6342cde44e5d7748b7790201ee4ead3 | |
| parent | 21c109d2f98a7f6752f0791b5780fba795d84132 (diff) | |
| download | DLT-daemon-1987fa2b75253d9f47cde8f4dd593509027147a5.tar.gz | |
doc: Limitation to SIGUSR1 usage on Androiddevel_v2.18.5_local_changes
Signed-off-by: Saya Sugiura <ssugiura@jp.adit-jv.com>
| -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 |