diff options
author | Laszlo Agocs <laszlo.agocs@qt.io> | 2016-07-26 13:59:14 +0200 |
---|---|---|
committer | Laszlo Agocs <laszlo.agocs@qt.io> | 2016-07-26 12:15:19 +0000 |
commit | 69da000a9875e60f13693bc0c48a87dd85274271 (patch) | |
tree | 0fc2d533b749b0f75cf7b3d73d166381a7c464f0 | |
parent | eb968a1bb1b6696e556ef6ddeb429bc85db092fd (diff) | |
download | qtdoc-69da000a9875e60f13693bc0c48a87dd85274271.tar.gz |
embedded: Document opt out from signal handling
Task-number: QTBUG-54733
Change-Id: I38843c93b5cc6e7ff9999e86b2fb06d05b2801cb
Reviewed-by: Andy Nichols <andy.nichols@qt.io>
-rw-r--r-- | doc/src/platforms/emb-linux.qdoc | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/src/platforms/emb-linux.qdoc b/doc/src/platforms/emb-linux.qdoc index 74ad8510..dfe60142 100644 --- a/doc/src/platforms/emb-linux.qdoc +++ b/doc/src/platforms/emb-linux.qdoc @@ -575,6 +575,20 @@ Use the \c fb plugin parameter to specify the framebuffer device to use. + \section1 Unix Signal Handlers + + The console-oriented platform plugins like eglfs and linuxfb install signal + handlers by default to capture interrupt (\c SIGINT), suspend and continue + (\c SIGTSTP, \c SIGCONT) and termination (\c SIGTERM). This way the keyboard, + terminal cursor, and possibly other graphics state can be restored when the + application terminates or gets suspended due to \c kill, or \c{Ctrl+C} or + \c{Ctrl+Z}. (although terminating or suspending via the keyboard is only + possible when \c{QT_QPA_ENABLE_TERMINAL_KEYBOARD} is set, as outlined above in + the Input section). However, in some cases capturing \c SIGINT can be + undesirable as it may conflict with remote debugging for instance. Therefore, + the environment variable \c{QT_QPA_NO_SIGNAL_HANDLER} is provided to opt out + from all built-in signal handling. + \section1 Platform Plugins for Windowing Systems on Embedded Linux Devices \section2 XCB |