grpc/tools/docker_runners/examples/gdb_in_docker.sh

#!/bin/bash
# Copyright 2021 The gRPC Authors
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

set -ex

# change to grpc repo root
cd "$(dirname "$0")/../../.."

# Use the docker image used as the default for C++ by run_tests.py
# To use the correct docker image for your experiments,
# note that every invocation of run_tests.py with "--use_docker"
# prints the docker image used as a debug message at the end of the run.
# This is expecially important when --compiler/--arch params are
# use, since they usually influence with docker image will be used
# by run_tests.py
export DOCKERFILE_DIR=tools/dockerfile/test/cxx_debian11_x64

# "--privileged" docker arg is required to be disable address randomization by gdb
# TODO: is "--security-opt=seccomp=unconfined" actually needed?
export DOCKER_EXTRA_ARGS="--privileged --security-opt=seccomp=unconfined"

# start the docker container with interactive shell
tools/docker_runners/run_in_docker.sh bash

# Run these commands under the docker container
#
# Install gdb (or similar command for non-debian based distros)
# $ apt-get update && apt-get install -y gdb
#
# Build e.g. the C tests
# $ ./tools/run_tests/run_tests.py -l c -c dbg --build_only
#
# Run a test under gdb
# NOTE: Some old distros (e.g. debian 8 "jessie") might have a gdb version
# that doesn't work with C++11 symbols properly and crashes when
# loading the symbols.
# See https://gcc.gnu.org/bugzilla/show_bug.cgi?id=61233
# $ gdb cmake/build/histogram_test