tyler.durden/icinga2
1
0
Fork 0
mirror of https://github.com/Icinga/icinga2.git synced 2025-07-26 23:24:09 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update TOC

Browse Source 
(cherry picked from commit 01d2a17683659e17b0cc311135937e0d5748a05d)
This commit is contained in:
Michael Friedrich 2018-12-04 10:58:44 +01:00
parent d9b5fe0ace
commit 242a7f5705
1 changed files with 21 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
doc/21-development.md
View File

@ -4,11 +4,16 @@ This chapter provides hints on Icinga 2 debugging,
development, package builds and tests. development, package builds and tests.
* [Debug Icinga 2](21-development.md#development-debug) * [Debug Icinga 2](21-development.md#development-debug)
* [GDB Backtrace](21-development.md#development-debug-gdb-backtrace)
* [Core Dump](21-development.md#development-debug-core-dump)
* [Develop Icinga 2](21-development.md#development-develop) * [Develop Icinga 2](21-development.md#development-develop)
* [Linux Dev Environment](21-development.md#development-linux-dev-env) * [Linux Dev Environment](21-development.md#development-linux-dev-env)
* [macOS Dev Environment](21-development.md#development-macos-dev-env) * [macOS Dev Environment](21-development.md#development-macos-dev-env)
* [Windows Dev Environment](21-development.md#development-windows-dev-env) * [Windows Dev Environment](21-development.md#development-windows-dev-env)
* [Package Builds](21-development.md#development-package-builds) * [Package Builds](21-development.md#development-package-builds)
* [RPM](21-development.md#development-package-builds-rpms)
* [DEB](21-development.md#development-package-builds-deb)
* [Windows](21-development.md#development-package-builds-windows)
* [Advanced Tips](21-development.md#development-advanced) * [Advanced Tips](21-development.md#development-advanced)
* [Tests](21-development.md#development-tests) * [Tests](21-development.md#development-tests)
@ -20,6 +25,7 @@ a stack trace or coredump if the application crashed. It is also useful
for developers working with different debuggers. for developers working with different debuggers.
> **Note:** > **Note:**
>
> This is intentionally mentioned before any development insights > This is intentionally mentioned before any development insights
> as debugging is a more frequent and commonly asked question. > as debugging is a more frequent and commonly asked question.
@ -131,6 +137,12 @@ a new gdb run.
#### GDB Backtrace <a id="development-debug-gdb-backtrace"></a> #### GDB Backtrace <a id="development-debug-gdb-backtrace"></a>
If Icinga 2 aborted its operation abnormally, generate a backtrace. If Icinga 2 aborted its operation abnormally, generate a backtrace.
> **Note**
>
> Please install the [required debug symbols](21-development.md#debug-requirements)
> prior to generating a backtrace.
`thread apply all` is important here since this includes all running threads. `thread apply all` is important here since this includes all running threads.
We need this information when e.g. debugging dead locks and hanging features. We need this information when e.g. debugging dead locks and hanging features.
@ -155,6 +167,11 @@ make sure to attach as much detail as possible.
If Icinga 2 is still running, generate a full backtrace from the running If Icinga 2 is still running, generate a full backtrace from the running
process and store it into a new file (e.g. for debugging dead locks). process and store it into a new file (e.g. for debugging dead locks).
> **Note**
>
> Please install the [required debug symbols](21-development.md#debug-requirements)
> prior to generating a backtrace.
Icinga 2 runs with 2 processes: main and command executor, therefore generate two backtrace logs Icinga 2 runs with 2 processes: main and command executor, therefore generate two backtrace logs
and add them to the GitHub issue. and add them to the GitHub issue.
@ -1395,7 +1412,7 @@ the Debian packaging Git repository (https://github.com/Icinga/deb-icinga2)
into your source tree and run the following command: into your source tree and run the following command:
``` ```
$ dpkg-buildpackage -uc -us dpkg-buildpackage -uc -us
``` ```
### Build Alpine Linux packages <a id="development-package-builds-alpine"></a> ### Build Alpine Linux packages <a id="development-package-builds-alpine"></a>