summaryrefslogtreecommitdiff
path: root/docx/14_y_watchdog.dox
diff options
context:
space:
mode:
authorChristian Linke <Christian.Linke@bmw.de>2016-02-11 07:28:47 +0100
committerChristian Linke <Christian.Linke@bmw.de>2016-02-15 09:00:59 +0100
commit5bcd206b9270d9a79e212f91723ea1a08a4d4859 (patch)
tree55b0cd4d07fbd7ebfd15d58d02e9cae6ae61b127 /docx/14_y_watchdog.dox
parent59080ecc2c8840fd85c561adea3f85f5344534a8 (diff)
downloadaudiomanager-5bcd206b9270d9a79e212f91723ea1a08a4d4859.tar.gz
* rework of the build structure, adopt to standard cmake package structure7.4
* check versions when loading the libs * introduction of the AudioManagerCore * give control plugin as file or directory * remove SQLITE * either find and use gmock or build and install it * fixed [Bug 411] * compile flag gnu11 is now used Signed-off-by: Christian Linke <Christian.Linke@bmw.de> Signed-off-by: Christian Linke <Christian.Linke@bmw.de>
Diffstat (limited to 'docx/14_y_watchdog.dox')
-rw-r--r--docx/14_y_watchdog.dox44
1 files changed, 44 insertions, 0 deletions
diff --git a/docx/14_y_watchdog.dox b/docx/14_y_watchdog.dox
new file mode 100644
index 0000000..a1facc5
--- /dev/null
+++ b/docx/14_y_watchdog.dox
@@ -0,0 +1,44 @@
+ /*
+ * Copyright (C) 2012, BMW AG
+ *
+ * This file is part of GENIVI Project AudioManager.
+ *
+ * Contributions are licensed to the GENIVI Alliance under one or more
+ * Contribution License Agreements.
+ *
+ * \copyright
+ * This Source Code Form is subject to the terms of the
+ * Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with
+ * this file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * \\author Christian Linke (christian.linke@bmw.de)
+ *
+ */
+
+/*!
+\page watchd The watchdog
+\section watchdconcept The watchdog concept
+The watchdog concept of the audiomanger is based on systemd. When systemd is configured via the unit file to use a watchdog and watchdog support is activated
+in the audiomanager, the audiomanager will reset the watchdog via the mainloop in the given interval to prevent systemd from restarting the audiomanager.\n
+If the audiomanager is stuck for whatever reason, systemd will not get this update and restart the audiomanager.
+
+
+\section configwatch Watchdog configuration
+By default, the watchdog is enabled in the audiomanager, you can disable the watchdog functionality by setting the cmake build option "WITH_SYSTEMD_WATCHDOG" to
+OFF, either by modifying the cmake cache with ccache or by passing -DWITH_SYSTEMD_WATCHDOG=OFF to cmake.\n
+The interval for checking the watchdog can be set in the unitfile of systemd by setting "WatchdogSec". The other settings need to be done as well:
+\code
+Restart=always
+WatchdogSec=2
+NotifyAccess=main
+\endcode
+The intervall for pinging systemd is set to the half of "WatchdogSec".
+
+\section winteg Integration with systemd
+The audiomanager will use the library proviced by "libsystemd-daemon" if it is available on the system. If this library is not available, the files sd-daemon.c and sd-daemon.h
+that are provided with the audiomanager and released under MIT licence by Lennard Poettering will be used to connect to systemd.
+
+more information can be found here: am::CAmWatchdog and sd-daemon.h .
+
+
+ */