Mercurial > hg > orthanc-book

annotate Sphinx/source/users/docker.rst.BAK @ 1061:7c6b752c2e30

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fix link
author Alain Mazy <am@orthanc.team>
date Mon, 15 Apr 2024 10:45:32 +0200
parents a3436ae3709c
children d2be251975d1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1008
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
1
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
2 For developers and power users, the images ``jodogne/orthanc-debug``
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3 contain the Orthanc core compiled in debug mode (i.e. with runtime
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 assertions enabled, and including debugging symbols). A ``gdb``
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
5 command-line session can be started as follows::
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
6
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
7 $ docker run -i -t --rm --entrypoint=bash --network=host --cap-add=SYS_PTRACE -p 4242:4242 -p 8042:8042 jodogne/orthanc-debug
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
8 # gdb --args Orthanc /etc/orthanc/ --verbose
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
9
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
10 Exceptions can be automatically caught by launching ``gdb`` as follows::
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
11
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12 # gdb --ex 'catch t' --ex r --ex bt --args ./Orthanc /etc/orthanc/ --verbose
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
13
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
14 Note that:
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
15
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
16 * The plugins are not available in this image yet.
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
17
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
18 * The Orthanc source code can be found in folder ``/root/orthanc``.
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
19
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
20 * The build artifacts can be found in folder ``/root/orthanc/Build``.
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
21
23a54088d604 Docker image jodogne/orthanc-debug is not maintained anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
22 * This command launches the mainline version. To start a released version,
1021
a3436ae3709c Orthanc 1.12.3
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1008
diff changeset
23 use e.g. ``jodogne/orthanc-debug:1.12.3``.