ユーザーガイド

Red Hat Developer Toolset は、Red Hat Enterprise Linux プラットフォームで開発者向けの Red Hat 製品です。これにより、複数のバージョンの Red Hat Enterprise Linux にインストールされ、使用できる、完全な開発およびパフォーマンス分析ツールが提供されます。また、Red Hat Developer Toolset ツールチェーンで構築された実行ファイルは、複数のバージョンの Red Hat Enterprise Linux にデプロイおよび実行できます。互換性の詳細情報は、「互換性」 を参照してください。

Red Hat Developer Toolset は、これらのプラットフォームにインストールする場合に、Red Hat Enterprise Linux 7 で提供されるデフォルトのシステムツールに代わるものではありません。開発者ツールの並列セットは、開発者がオプションで使用するための代替の、新しいバージョンのツールを提供します。デフォルトのコンパイラーとデバッガーは、ベースの Red Hat Enterprise Linux システムが提供するもののままです。

Red Hat Developer Toolset 11.0 の新機能

Red Hat Developer Toolset 4.1 以降、Red Hat Developer Toolset コンテンツは、他の Red Hat Software Collections コンテンツ (https://access.redhat.com/downloads) (特に Server および Workstation) とともに ISO 形式で利用できます。「オプションパッケージのインストール」 で説明している Optional チャンネルを必要とするパッケージは、ISO イメージからインストールできないことに注意してください。

Red Hat Developer Toolset は、これまで Red Hat Enterprise Linux で提供されていた テクノロジープレビュー コンパイラーリリースとは異なります。

重要なバグ修正およびセキュリティーエラータは、各メジャーバージョンリリースから 2 年間 Red Hat Enterprise Linux と似た方法で Red Hat Developer Toolset サブスクライバーに発行されます。Red Hat Developer Toolset の新規メジャーバージョンは、年次リリースされ、既存のコンポーネントに重要な更新を提供し、主要な新規コンポーネントを追加します。新しいメジャーリリースバージョンリリースの 6 か月後に発行される新しい単一のマイナーリリースでは、バグ修正、セキュリティーエラータ、および新しいマイナーリリースの小規模な更新が提供されます。

また、Red Hat Enterprise Linux アプリケーションの互換性仕様 は、Red Hat Developer Toolset にも適用されます (「C++ 互換性」 にも説明されている新しいバージョンの C++11 言語機能を使用する一部の制限に影響を受けます)。

Red Hat Developer Toolset 11.0 には、以下の変更があります。

本リリースで導入された変更および機能の完全リストは、付録A バージョン 11.0 の変更点 を参照してください。

Red Hat Developer Toolset 11.0 は、数多くのアーキテクチャーで Red Hat Enterprise Linux 7 で利用できます。

ABI の互換性情報は、「C++ 互換性」 を参照してください。

アーキテクチャーのサポート

Red Hat Developer Toolset は、以下のアーキテクチャーで利用できます。

Red Hat Developer Toolset は、Red Hat Software Collections の一部として配布されるオファリングです。

このコンテンツセットは、https://access.redhat.com/solutions/472793 に記載されている Red Hat Enterprise Linux 7 サブスクリプションをご利用いただけます。

Red Hat Subscription Management を使用して Red Hat Developer Toolset を有効にします。このサブスクリプション管理サービスでシステムを登録する方法は、ガイドの Red Hat Subscription Management コレクションを参照してください。

Red Hat Developer Toolset は、Red Hat Enterprise Linux に含まれる標準のパッケージ管理ツールを使用してインストール、更新、アンインストール、および検査できる RPM パッケージのコレクションとして配布されています。Red Hat Developer Toolset をシステムにインストールするには、Red Hat Software Collections コンテンツセットへのアクセスを提供する有効なサブスクリプションが必要です。システムを適切なサブスクリプションに関連付け、Red Hat Developer Toolset にアクセスする方法は、9「Red Hat Developer Toolset へのアクセスの取得」 を参照してください。

# yum install devtoolset-11

# yum install package_name

# yum install devtoolset-11-toolchain

$ yum list available devtoolset-11-\*

# yum install package_name

# yum install devtoolset-11-gdb-gdbserver devtoolset-11-gdb-doc

# debuginfo-install package_name

# debuginfo-install devtoolset-11-dwz

システムから Red Hat Developer Toolset パッケージをアンインストールするには、以下を実行します。

# yum remove devtoolset-11\* libasan libatomic libcilkrts libitm liblsan libtsan libubsan

これにより、GNU Compiler Collection、GNU Debugger、binutils、およびシステムから Red Hat Developer Toolset に含まれるその他のパッケージが削除されます。

Red Hat Developer Toolset が提供するツールのアンインストールは、これらのツールの Red Hat Enterprise Linux システムバージョンには影響しないことに注意してください。

Docker 形式のコンテナーイメージ を使用して、仮想ソフトウェアコンテナー内で Red Hat Developer Toolset コンポーネントを実行することができます。そのため、それらをホストシステムから分離し、迅速なデプロイメントを可能にします。Red Hat Developer Toolset docker 形式のコンテナーイメージおよび Red Hat Developer Toolset Dockerfile の詳細は、Using Red Hat Software Collections Container Images を参照してください。

Red Hat Developer Toolset および Red Hat Enterprise Linux の詳細は、以下の資料を参照してください。

オンラインドキュメント

関連項目

$ scl enable devtoolset-11 'gcc -lsomelib objfile.o'

このように、Red Hat Developer Toolset のライブラリーを使用すると、リンカーのエラーメッセージで、undefined reference to symbol になります。この問題を回避するには、標準のリンクプラクティスに従い、オブジェクトファイルを指定するオプションの後に、ライブラリーを追加するオプションを指定します。

$ scl enable devtoolset-11 'gcc objfile.o -lsomelib'

この推奨事項は、Red Hat Enterprise Linux のベースバージョンの GCC を使用する場合にも適用されることに注意してください。

GNU Compiler Collections およびその機能の詳細は、以下の資料を参照してください。

インストールされているドキュメント

オンラインドキュメント

関連項目

Red Hat Developer Toolset では、devtoolset-11-make パッケージにより GNU make が提供され、「Red Hat Developer Toolset のインストール」 の説明通りに devtoolset-11-toolchain で自動的にインストールされます。

Makefile を使用せずにプログラムを構築するには、以下のように make ツールを実行します。

$ scl enable devtoolset-11 'make source_file_without_extension'

このコマンドは、C、C++、Fortran を含む多数のプログラミング言語に定義される暗黙的なルールを利用します。結果は、現在の作業ディレクトリーの source_file_without_extension という名前のバイナリーファイルです。

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset make でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

$ which make

$ make -v

#include <stdio.h>

int main(int argc, char *argv[]) {
  printf("Hello, World!\n");
  return 0;
}

$ scl enable devtoolset-11 'make hello'
cc     hello.c   -o hello

複数のソースファイルで設定される複雑なプログラムを構築するには、make は Makefile と呼ばれる設定ファイルを使用して、プログラムのコンポーネントをコンパイルし、最終的な実行可能ファイルを構築する方法を制御します。Makefile には、作業ディレクトリーのクリーニング、プログラムファイルのインストールおよびアンインストール、およびその他の操作の指示を含めることもできます。

make は、現在のディレクトリーの GNUmakefile、makefile、または Makefile というファイルを自動的に使用します。別のファイル名を指定するには、-f オプションを使用します。

$ make -f make_file

Makefile 構文の詳細の説明は、このガイドの対象外です。GNU make、アップストリームの GNU make マニュアルを参照してください。これは、GNU make ユーティリティー、Makefile 構文、その使用方法を詳細に説明しています。

完全な make マニュアルは、インストールの一部として Texinfo 形式でも利用できます。このマニュアルを表示するには、次のコマンドを実行します。

$ scl enable devtoolset-11 'info make'

CC=gcc
CFLAGS=-c -Wall
SOURCE=hello.c
OBJ=$(SOURCE:.c=.o)
EXE=hello

all: $(SOURCE) $(EXE)

$(EXE): $(OBJ)
        $(CC) $(OBJ) -o $@

.o: .c
        $(CC) $(CFLAGS) $< -o $@

clean:
        rm -rf $(OBJ) $(EXE)

$ scl enable devtoolset-11 'make'
gcc -c -Wall hello.c -o hello.o
gcc hello.o -o hello

$ scl enable devtoolset-11 'make clean'
rm -rf hello.o hello

GNU make ツールとその機能の詳細は、以下の資料を参照してください。

インストールされているドキュメント

オンラインドキュメント

関連項目

Red Hat Developer Toolset では、「Red Hat Developer Toolset のインストール」 で説明されているように、devtoolset-11-binutils パッケージでbinutils が提供され、devtoolset-11-toolchain で自動的にインストールされます。

アセンブリー言語プログラムからオブジェクトファイルを生成するには、以下のように as ツールを実行します。

$ scl enable devtoolset-11 'as option ... -o object_file source_file'

これにより、現在の作業ディレクトリーに object_file という名前のオブジェクトファイルが作成されます。

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset as でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

$ which as

$ as -v

オブジェクトファイルから実行可能なバイナリーファイルまたはライブラリーを作成するには、以下のように ld ツールを実行します。

$ scl enable devtoolset-11 'ld option ... -o output_file object_file ...'

これにより、現在の作業ディレクトリーに output_file という名前のバイナリーファイルが作成されます。-o オプションを省略すると、コンパイラーはデフォルト a.out でという名前のファイルを作成します。

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset ld でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

$ which ld

$ ld -v

binutils は、リンカーやアセンブラー以外の多くのバイナリーツールを提供します。これらのツールのリストは、表4.1「Red Hat Developer Toolset の binutils に含まれるツール」 を参照してください。

binutils の一部であるツールを実行するには、次のコマンドを実行します。

$ scl enable devtoolset-11 'tool option ... file_name'

binutils で配布されるツールのリストは、表4.1「Red Hat Developer Toolset の binutils に含まれるツール」 を参照してください。たとえば、objdump ツールを使用してオブジェクトファイルを検査するには、次のコマンドを実行します。

$ scl enable devtoolset-11 'objdump option ... object_file'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、Red Hat Developer Toolset バイナリーツールでシェルセッションをデフォルトとして実行できます。

$ scl enable devtoolset-11 'bash'

$ which objdump

$ objdump -v

$ scl enable devtoolset-11 'ld -lsomelib objfile.o'

このように、Red Hat Developer Toolset のライブラリーを使用すると、リンカーのエラーメッセージで、undefined reference to symbol になります。この問題を回避するには、標準のリンクプラクティスに従い、オブジェクトファイルを指定するオプションの後に、ライブラリーを追加するオプションを指定します。

$ scl enable devtoolset-11 'ld objfile.o -lsomelib'

また、この推奨事項は、Red Hat Enterprise Linux のベースバージョンの binutils を使用している場合にも適用されることに注意してください。

binutils の詳細は、以下に記載のドキュメントを参照してください。

インストールされているドキュメント

オンラインドキュメント

関連項目

Red Hat Developer Toolset では、devtoolset-11-elfutils パッケージにより elfutils が提供され、「Red Hat Developer Toolset のインストール」 の説明通りに devtoolset-11-toolchain で自動的にインストールされます。

elfutils の一部であるツールのいずれかを実行するには、以下のようにツールを実行します。

$ scl enable devtoolset-11 'tool option ... file_name'

elfutils で配布されるツールのリストは、表5.1「Red Hat Developer Toolset の elfutils に含まれるツール」 を参照してください。たとえば、eu-objdump ツールを使用してオブジェクトファイルを検査するには、次のコマンドを実行します。

$ scl enable devtoolset-11 'eu-objdump option ... object_file'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、Red Hat Developer Toolset バイナリーツールでシェルセッションをデフォルトとして実行できます。

$ scl enable devtoolset-11 'bash'

$ which eu-objdump

$ eu-objdump -V

elfutils の詳細は、以下に記載のドキュメントを参照してください。

関連項目

Red Hat Developer Toolset では、dwz ユーティリティーは devtoolset-11-dwz パッケージで提供され、「Red Hat Developer Toolset のインストール」 の説明に従って devtoolset-11-toolchain で自動的にインストールされます。

バイナリーファイルで DWARF デバッグ情報を最適化するには、以下のように dwz ツールを実行します。

$ scl enable devtoolset-11 'dwz option... file_name'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset dwz でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

$ which dwz

$ dwz -v

dwz とその機能の詳細は、以下に挙げるリソースを参照してください。

インストールされているドキュメント

関連項目

Red Hat Developer Toolset では、annobin プラグインおよび annocheck プログラムは devtoolset-11-gcc パッケージで提供され、「オプションパッケージのインストール」 の説明に従ってインストールされます。

gcc を使用して annobin プラグインにオプションを渡すには、以下を使用します。

$ scl enable devtoolset-11 'gcc -fplugin=annobin -fplugin-arg-annobin-option file-name'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset as でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

annocheck プログラムでファイル、ディレクトリー、または RPM パッケージをスキャンするには、次のコマンドを実行します。

$ scl enable devtoolset-11 'annocheck file-name'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset as でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

$ which annocheck

$ annocheck --version

annocheck、annobin、およびその機能の詳細は、以下の資料を参照してください。

インストールされているドキュメント

Red Hat Developer Toolset では、GNU デバッガー は devtoolset-11-gdb パッケージで提供され、「Red Hat Developer Toolset のインストール」 の説明に従って devtoolset-11-toolchain で自動的にインストールされます。

デバッグ情報を使用したプログラムのコンパイル

GNU デバッガー が読み取り可能なデバッグ情報で C プログラムをコンパイルするには、-g オプションを指定して gcc コンパイラーが実行されていることを確認します。

$ scl enable devtoolset-11 'gcc -g -o output_file input_file...'

同様に、デバッグ情報を使用して C++ プログラムをコンパイルするには、以下を実行します。

$ scl enable devtoolset-11 'g++ -g -o output_file input_file...'

#include <stdio.h>
#include <limits.h>

int main (int argc, char *argv[]) {
  unsigned long int a = 0;
  unsigned long int b = 1;
  unsigned long int sum;

  while (b < LONG_MAX) {
    printf("%ld ", b);
    sum = a + b;
    a = b;
    b = sum;
  }

  return 0;
}

$ scl enable devtoolset-11 'gcc -g -o fibonacci fibonacci.c'

既存パッケージのデバッグ情報のインストール

システムにすでにインストールされているパッケージのデバッグ情報をインストールするには、次のコマンドを実行します。

# debuginfo-install package_name

debuginfo-install ユーティリティーをシステムで使用できるようにするには、yum-utils パッケージがインストールされている必要があることに注意してください。

# debuginfo-install glibc
Loaded plugins: product-id, refresh-packagekit, subscription-manager
--> Running transaction check
---> Package glibc-debuginfo.x86_64 0:2.17-105.el7 will be installed
...

デバッグするプログラムで GNU デバッガー を実行するには、以下を実行します。

$ scl enable devtoolset-11 'gdb file_name'

これにより、インタラクティブモードで gdb デバッガーが開始され、デフォルトのプロンプト (gdb) が表示されます。デバッグセッションを終了してシェルプロンプトに戻るには、いつでも以下のコマンドを実行します。

(gdb) quit

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset gdb でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

$ which gdb

$ gdb -v

$ scl enable devtoolset-11 'gdb fibonacci'
GNU gdb (GDB) Red Hat Enterprise Linux 8.2-2.el7
Copyright (C) 2017 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
and "show warranty" for details.
This GDB was configured as "x86_64-redhat-linux-gnu".
Type "show configuration" for configuration details.
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Find the GDB manual and other documentation resources online at:
<http://www.gnu.org/software/gdb/documentation/>.
For help, type "help".
Type "apropos word" to search for commands related to "word"...
Reading symbols from fibonacci...done.
(gdb)

デバッグしているプログラムのソースコードを表示するには、次のコマンドを実行します。

(gdb) list

デバッグしているプログラムの実行を開始する前に、gdb はソースコードの最初の 10 行を表示し、その後に使用しても別の 10 行がリスト表示されます。実行を開始すると、gdb は通常はブレークポイントを設定する際に実行が停止した行を取ります。

特定の行を取り囲むコードを表示することもできます。

(gdb) list file_name:line_number

同様に、特定の関数の開始点を囲むコードを表示するには、次のコマンドを実行します。

(gdb) list file_name:function_name

list コマンドが表示する行数を変更できます。

(gdb) set listsize number

(gdb) set listsize 20

(gdb) list
1       #include <stdio.h>
2       #include <limits.h>
3
4       int main (int argc, char *argv[]) {
5         unsigned long int a = 0;
6         unsigned long int b = 1;
7         unsigned long int sum;
8
9         while (b < LONG_MAX) {
10          printf("%ld ", b);
11          sum = a + b;
12          a = b;
13          b = sum;
14        }
15
16        return 0;
17      }

新しいブレークポイントの設定

特定の行に新しいブレークポイントを設定するには、以下を行います。

(gdb) break file_name:line_number

特定の関数でブレークポイントを設定することもできます。

(gdb) break file_name:function_name

(gdb) break 10
Breakpoint 1 at 0x4004e5: file fibonacci.c, line 10.

ブレークポイントのリスト表示

現在設定されているブレークポイントのリストを表示するには、次のコマンドを実行します。

(gdb) info breakpoints

(gdb) info breakpoints
Num     Type           Disp Enb Address            What
1       breakpoint     keep y   0x00000000004004e5 in main at fibonacci.c:10

既存のブレークポイントの削除

特定の行に設定されているブレークポイントを削除するには、次のコマンドを実行します。

(gdb) clear line_number

同様に、特定の関数に設定したブレークポイントを削除するには、次のコマンドを実行します。

(gdb) clear function_name

(gdb) break 7
Breakpoint 2 at 0x4004e3: file fibonacci.c, line 7.

(gdb) clear 7
Deleted breakpoint 2

デバッグしているプログラムの実行を開始するには、次のコマンドを実行します。

(gdb) run

プログラムがコマンドライン引数を許可する場合は、run コマンドに引数として指定できます。

(gdb) run argument…

最初のブレークポイント (存在する場合) に達するか、エラーが発生した場合、またはプログラムが終了したときに実行が停止します。

(gdb) run
Starting program: /home/john/fibonacci

Breakpoint 1, main (argc=1, argv=0x7fffffffe4d8) at fibonacci.c:10
10          printf("%ld ", b);

この gdb ユーティリティーを使用すると、複雑で、有効な式やライブラリー機能まで、プログラムに関連するほぼすべての値を表示できます。ただし、変数の値を表示するのが最も一般的なタスクです。

特定の変数の現在の値を表示するには、次のコマンドを実行します。

(gdb) print variable_name

(gdb) print a
$1 = 0
(gdb) print b
$2 = 1

ブレークポイントに達した後にデバッグするプログラムの実行を再開するには、次のコマンドを実行します。

(gdb) continue

別のブレークポイントに到達すると、実行が再び停止します。特定の数のブレークポイントをスキップするには (通常はループをデバッグする場合)、以下を実行します。

(gdb) continue number

この gdb ユーティリティーでは、1 行のコードを実行した後に実行を停止することもできます。

(gdb) step

最後に、特定の数行を実行できます。

(gdb) step number

(gdb) continue
Continuing.

Breakpoint 1, main (argc=1, argv=0x7fffffffe4d8) at fibonacci.c:10
10          printf("%ld ", b);

(gdb) step 3
13          b = sum;

(gdb) print sum
$3 = 2

GNU デバッガー およびその機能の詳細は、以下の資料を参照してください。

インストールされているドキュメント

devtoolset-11-gdb-doc パッケージをインストールすると、/opt/rh/devtoolset-11/root/usr/share/doc/devtoolset-11-gdb-doc-10.2 ディレクトリーの HTML 形式および PDF 形式のドキュメントを利用できます。

オンラインドキュメント

関連項目

Red Hat Enterprise Linux では、strace ユーティリティーは devtoolset-11-strace パッケージで提供され、「Red Hat Developer Toolset のインストール」 の説明通りに devtoolset-11-toolchain で自動的にインストールされます。

分析するプログラムで strace ユーティリティーを実行するには、次のコマンドを実行します。

$ scl enable devtoolset-11 'strace program argument...'

program を、分析するプログラムの名前に置き換え、argument を、このプログラムに指定するコマンドラインオプションと引数に置き換えます。以下の例では、-p コマンドラインオプションとプロセス ID を使用して、実行中のプロセスでユーティリティーを実行できます。

$ scl enable devtoolset-11 'strace -p process_id'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset strace でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

$ which strace

$ strace -V

$ scl enable devtoolset-11 'strace -o file_name program argument...'

$ scl enable devtoolset-11 'strace -o fibonacci.log ./fibonacci 20'
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597 2584 4181 6765

$ scl enable devtoolset-11 'strace -e expression program argument...'

$ scl enable devtoolset-11 'strace -e mmap,munmap ./employee'
mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f896c744000
mmap(NULL, 61239, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f896c735000
mmap(0x3146a00000, 3745960, PROT_READ|PROT_EXEC, MAP_PRIVATE|MAP_DENYWRITE, 3, 0) = 0x3146a00000
mmap(0x3146d89000, 20480, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_DENYWRITE, 3, 0x189000) = 0x3146d89000
mmap(0x3146d8e000, 18600, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_ANONYMOUS, -1, 0) = 0x3146d8e000
mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f896c734000
mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f896c733000
mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f896c732000
munmap(0x7f896c735000, 61239)           = 0
mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f896c743000
John,john@example.comDoe,
+++ exited with 0 +++

$ scl enable devtoolset-11 'strace -t program argument...'

$ scl enable devtoolset-11 'strace -tt program argument...'

$ scl enable devtoolset-11 'strace -r program argument...'

$ scl enable devtoolset-11 'strace -tt pwd'
19:43:28.011815 execve("./pwd", ["./pwd"], [/* 36 vars */]) = 0
19:43:28.012128 brk(0)                  = 0xcd3000
19:43:28.012174 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7fc869cb0000
19:43:28.012427 open("/etc/ld.so.cache", O_RDONLY) = 3
19:43:28.012446 fstat(3, {st_mode=S_IFREG|0644, st_size=61239, ...}) = 0
19:43:28.012464 mmap(NULL, 61239, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7fc869ca1000
19:43:28.012483 close(3)                = 0
...
19:43:28.013410 +++ exited with 0 +++

$ scl enable devtoolset-11 'strace -c program argument...'

$ scl enable devtoolset-11 'strace -c lsblk > /dev/null'
% time     seconds  usecs/call     calls    errors syscall
------ ----------- ----------- --------- --------- ----------------
 80.88    0.000055           1       106        16 open
 19.12    0.000013           0       140           munmap
  0.00    0.000000           0       148           read
  0.00    0.000000           0         1           write
  0.00    0.000000           0       258           close
  0.00    0.000000           0        37         2 stat
...
------ ----------- ----------- --------- --------- ----------------
100.00    0.000068                  1790        35 total

$ scl enable devtoolset-11 'strace -e fault=syscall program argument...'

$ scl enable devtoolset-11 'strace -e inject=syscall:error=error-type program argument'
$ scl enable devtoolset-11 'strace -e inject=syscall:retval=return-value program argument'

$ scl enable devtoolset-11 'strace -e fault=mmap:error=EPERM lsblk > /dev/null'
execve("/usr/bin/lsblk", ["lsblk"], 0x7fff1c0e02a0 /* 54 vars */) = 0
brk(NULL)                               = 0x55d9e8b43000
mmap(NULL, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = -1 EPERM (Operation not permitted) (INJECTED)
writev(2, [{iov_base="lsblk", iov_len=5}, {iov_base=": ", iov_len=2}, {iov_base="error while loading shared libra"..., iov_len=36}, {iov_base=": ", iov_len=2}, {iov_base="", iov_len=0}, {iov_base="", iov_len=0}, {iov_base="cannot create cache for search p"..., iov_len=35}, {iov_base=": ", iov_len=2}, {iov_base="Cannot allocate memory", iov_len=22}, {iov_base="\n", iov_len=1}], 10lsblk: error while loading shared libraries: cannot create cache for search path: Cannot allocate memory
) = 105
exit_group(127)                         = ?
+++ exited with 127 +++

strace とその機能の詳細は、以下に挙げるリソースを参照してください。

インストールされているドキュメント

関連項目

Red Hat Enterprise Linux では、ltrace ユーティリティーは devtoolset-11-ltrace パッケージで提供され、「Red Hat Developer Toolset のインストール」 の説明通りに devtoolset-11-toolchain で自動的にインストールされます。

分析するプログラムで ltrace ユーティリティーを実行するには、次のコマンドを実行します。

$ scl enable devtoolset-11 'ltrace program argument...'

program を、分析するプログラムの名前に置き換え、argument を、このプログラムに指定するコマンドラインオプションと引数に置き換えます。以下の例では、-p コマンドラインオプションとプロセス ID を使用して、実行中のプロセスでユーティリティーを実行できます。

$ scl enable devtoolset-11 'ltrace -p process_id'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、デフォルトで Red Hat Developer Toolset ltrace でシェルセッションを実行できます。

$ scl enable devtoolset-11 'bash'

$ which ltrace

$ ltrace -V

$ scl enable devtoolset-11 'ltrace -o file_name program argument...'

$ scl enable devtoolset-11 'ltrace -o fibonacci.log ./fibonacci 20'
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597 2584 4181 6765

$ scl enable devtoolset-11 'ltrace -e expression program argument...'

$ scl enable devtoolset-11 'ltrace -e malloc+free-@libc.so* program'

$ scl enable devtoolset-11 'ltrace -e opendir+readdir+closedir ls'
ls->opendir(".")     = { 3 }
ls->readdir({ 3 })   = { 61533, "." }
ls->readdir({ 3 })   = { 131, ".." }
ls->readdir({ 3 })   = { 67185100, "BUILDROOT" }
ls->readdir({ 3 })   = { 202390772, "SOURCES" }
ls->readdir({ 3 })   = { 60249, "SPECS" }
ls->readdir({ 3 })   = { 67130110, "BUILD" }
ls->readdir({ 3 })   = { 136599168, "RPMS" }
ls->readdir({ 3 })   = { 202383274, "SRPMS" }
ls->readdir({ 3 })   = nil
ls->closedir({ 3 })  = 0
BUILD  BUILDROOT  RPMS  SOURCES  SPECS  SRPMS
+++ exited (status 0) +++

$ scl enable devtoolset-11 'ltrace -t program argument...'

$ scl enable devtoolset-11 'ltrace -tt program argument...'

$ scl enable devtoolset-11 'ltrace -r program argument...'

$ scl enable devtoolset-11 'ltrace -tt pwd'
13:27:19.631371 __libc_start_main([ "pwd" ] <unfinished ...>
13:27:19.632240 getenv("POSIXLY_CORRECT")                        = nil
13:27:19.632520 strrchr("pwd", '/')                              = nil
13:27:19.632786 setlocale(LC_ALL, "")                            = "en_US.UTF-8"
13:27:19.633220 bindtextdomain("coreutils", "/usr/share/locale") = "/usr/share/locale"
13:27:19.633471 textdomain("coreutils")                          = "coreutils"
(...)
13:27:19.637110  exited (status 0)

$ scl enable devtoolset-11 'ltrace -c program argument...'

$ scl enable devtoolset-11 'ltrace -c lsblk > /dev/null'
% time     seconds  usecs/call     calls      function
------ ----------- ----------- --------- --------------------
 53.60    0.261644      261644         1 __libc_start_main
  4.48    0.021848          58       374 mbrtowc
  4.41    0.021524          57       374 wcwidth
  4.39    0.021409          57       374 __ctype_get_mb_cur_max
  4.38    0.021359          57       374 iswprint
  4.06    0.019838          74       266 readdir64
  3.21    0.015652          69       224 strlen
...
------ ----------- ----------- --------- --------------------
100.00    0.488135                  3482 total

ltrace とその機能の詳細は、以下に挙げるリソースを参照してください。

インストールされているドキュメント

オンラインドキュメント

関連項目

Red Hat Developer Toolset では、memstomp ユーティリティーは devtoolset-11-memstomp パッケージで提供され、「Red Hat Developer Toolset のインストール」 で説明されているように devtoolset-11-toolchain を使用して自動的にインストールされます。

分析するプログラムで memstomp ユーティリティーを実行するには、以下を実行します。

$ scl enable devtoolset-11 'memstomp program argument...'

問題が検出されたときに、解析されたプログラムをすぐに終了するには、--kill (または -k) コマンドラインオプションを指定してユーティリティーを実行します。

$ scl enable devtoolset-11 'memstomp --kill program argument...'

マルチスレッドプログラムを分析する場合は、--kill オプションの使用が特に推奨されます。バックトレースの内部実装はスレッドセーフではなく、このオプションなしでマルチスレッドプログラムで memstomp ユーティリティーを実行すると信頼できない結果が発生する可能性があります。

さらに、解析しているプログラムをデバッグ情報でコンパイルした場合や、このデバッグ情報が利用できる場合は、--debug-info (または -d) コマンドラインオプションを使用して、より詳細なバックトレースを作成できます。

$ scl enable devtoolset-11 'memstomp --debug-info program argument...'

バイナリーファイルにビルドされたデバッグ情報を使用してプログラムをコンパイルする方法は、「デバッグプログラムの準備」 を参照してください。Red Hat Developer Toolset パッケージのデバッグ情報をインストールする方法は、「デバッグ情報のインストール」 を参照してください。

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、Red Hat Developer Toolset memstomp をデフォルトとして設定して、シェルセッションを実行することができます。

$ scl enable devtoolset-11 'bash'

#include <stdio.h>
#include <string.h>

#define BUFSIZE 80

int main(int argc, char *argv[]) {
  char employee[BUFSIZE] = "John,Doe,john@example.com";
  char name[BUFSIZE] = {0};
  char surname[BUFSIZE] = {0};
  char *email;
  size_t length;

  /* Extract the information: */
  memccpy(name, employee, ',', BUFSIZE);
  length = strlen(name);
  memccpy(surname, employee + length, ',', BUFSIZE);
  length += strlen(surname);
  email = employee + length;

  /* Compose the new entry: */
  strcat(employee, surname);
  strcpy(employee, name);
  strcat(employee, email);

  /* Print the result: */
  puts(employee);

  return 0;
}

$ scl enable devtoolset-11 'gcc -rdynamic -g -o employee employee.c'

$ scl enable devtoolset-11 'memstomp --debug-info ./employee'
memstomp: 0.1.4 successfully initialized for process employee (pid 14887).

strcat(dest=0x7fff13afc265, src=0x7fff13afc269, bytes=21) overlap for employee(14887)
        ??:0    strcpy()
        ??:0    strcpy()
        ??:0    _Exit()
        ??:0    strcat()
        employee.c:26   main()
        ??:0    __libc_start_main()
        ??:0    _start()
John,john@example.comDoe,

memstomp とその機能の詳細は、以下に挙げるリソースを参照してください。

インストールされているドキュメント

関連項目

Red Hat Developer Toolset SystemTap は、devtoolset-11-systemtap パッケージで提供され、「Red Hat Developer Toolset のインストール」 の説明に従って devtoolset-11-perftools で自動的にインストールされます。

インストルメンテーションを Linux カーネルに配置するために、SystemTap ではデバッグ情報を含む追加パッケージをインストールする必要がある場合があります。インストールするパッケージを確認するには、以下のように stap-prep ユーティリティーを実行します。

$ scl enable devtoolset-11 'stap-prep'

このコマンドを root ユーザーとして実行すると、このユーティリティーが自動的にインストール用のパッケージを提供することに注意してください。システムにこのパッケージをインストールする方法は、Red Hat Enterprise Linux 7 SystemTap Beginners Guideを参照してください。

SystemTap に含まれるツールのいずれかを実行するには、以下を実行します。

$ scl enable devtoolset-11 'tool option...'

SystemTap で配布されるツールのリストは、表12.1「Red Hat Developer Toolset の SystemTap に分散したツール」 を参照してください。たとえば、stap ツールを実行してインストルメンテーションモジュールを構築するには、次のコマンドを実行します。

$ scl enable devtoolset-11 'stap option... argument...'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、Red Hat Developer Toolset SystemTap でシェルセッションをデフォルトとして実行できます。

$ scl enable devtoolset-11 'bash'

$ which stap

$ stap -V

SystemTap とその機能の詳細は、以下に挙げるリソースを参照してください。

インストールされているドキュメント

オンラインドキュメント

関連項目

Red Hat Developer Toolset では、devtoolset-11-valgrind パッケージで Valgrind が提供され、devtoolset-11-perftools で自動的にインストールされます。

Red Hat Developer Toolset および関連パッケージをシステムにインストールする方法は、「Red Hat Developer Toolset のインストール」 を参照してください。

プロファイルするプログラムで Valgrind ツールを実行するには、次のコマンドを実行します。

$ scl enable devtoolset-11 'valgrind --tool=tool program argument...'

Valgrind で配布されるツールのリストは、表13.1「Red Hat Developer Toolset の Valgrind で配布されるツール」 を参照してください。--tool コマンドラインオプションの引数は小文字で指定する必要があります。このオプションを省略すると、Valgrind はデフォルトで Memcheck を使用します。たとえば、プログラムで Cachegrind を実行して、キャッシュミスのソースを特定するには、以下を実行します。

$ scl enable devtoolset-11 'valgrind --tool=cachegrind program argument...'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、Red Hat Developer Toolset Valgrind でシェルセッションをデフォルトとして実行できます。

$ scl enable devtoolset-11 'bash'

$ which valgrind

$ valgrind --version

Valgrind およびその機能の詳細は、以下に挙げるリソースを参照してください。

インストールされているドキュメント

オンラインドキュメント

関連項目

Red Hat Developer Toolset では、OProfile は devtoolset-11-oprofile パッケージで提供され、「Red Hat Developer Toolset のインストール」 で説明されているように devtoolset-11-perftools で自動的にインストールされます。

OProfile で配布されるツールのいずれかを実行するには、以下を実行します。

# scl enable devtoolset-11 'tool option...'

OProfile で配布されるツールのリストは、表14.1「Red Hat Developer Toolset の OProfile と配布されるツール」 を参照してください。たとえば、ophelp コマンドを使用して、XML 形式で利用可能なイベントをリスト表示します。

$ scl enable devtoolset-11 'ophelp -X'

この scl ユーティリティーを使用してコマンドを実行すると、これを Red Hat Enterprise Linux システムに優先して使用する Red Hat Developer Toolset バイナリーで実行することができることに注意してください。これにより、Red Hat Developer Toolset OProfile でシェルセッションをデフォルトとして実行できます。

$ scl enable devtoolset-11 'bash'

$ which operf

# operf --version

OProfile とその機能の詳細は、以下に挙げるリソースを参照してください。

インストールされているドキュメント

オンラインドキュメント

関連項目

Red Hat Developer Toolset では、Dyninst ライブラリー は devtoolset-11-dyninst パッケージで提供され、「Red Hat Developer Toolset のインストール」 で説明されているように devtoolset-11-perftools で自動的にインストールされます。さらに、devtoolset-11-toolchain パッケージが提供する GNU コンパイラーコレクション をインストールすることが推奨されます。

バイナリー用のカスタムインストルメンテーションを作成する場合は、関連するヘッダーファイルをインストールします。

# yum install devtoolset-11-dyninst-devel

このライブラリーの API ドキュメントをインストールすることもできます。

# yum install devtoolset-11-dyninst-doc

devtoolset-11-dyninst-doc パッケージに含まれるドキュメントの完全なリストは、「関連情報」 を参照してください。システムにオプションパッケージをインストールする方法の詳細は、「Red Hat Developer Toolset のインストール」 を参照してください。

Dyninst およびその機能の詳細は、以下の資料を参照してください。

インストールされているドキュメント

The devtoolset-11-dyninst-doc パッケージは、以下のドキュメントを /opt/rh/devtoolset-11/root/usr/share/doc/devtoolset-11-dyninst-doc-11.0.0/ ディレクトリーにインストールします。

システムにこのパッケージをインストールする方法は、「Dyninst のインストール」 を参照してください。

オンラインドキュメント

関連項目

GSS と通信する前に、いくつかの情報を取得する必要があります。

背景情報

GSS を呼び出す前に、以下の背景情報があることを確認してください。

診断

Red Hat Enterprise Linux の診断レポートも必要です。このレポートは sosreport とも呼ばれ、レポートを作成するプログラムは sos パッケージで提供されます。sos パッケージとそのすべての依存関係をシステムにインストールするには、以下を実行します。

# yum install sos

レポートを生成するには、次のコマンドを実行します。

# sosreport

詳細は、ナレッジベースの記事 https://access.redhat.com/kb/docs/DOC-3593 を参照してください。

アカウントおよび連絡先情報

お客様にヘルプを提供するため、GSS は、サポートのニーズに応じた調整を行い、連絡を行うためにアカウント情報が必要です。GSS にアクセスする際には、以下の点を確認してください。

問題の重大度

GSS チームが作業の優先順位を決定できるようにするには、問題の重大度を判断することが重要です。重大度は 4 つあります。

問題の重大度を判断する方法は、https://access.redhat.com/support/policy/severity を参照してください。

問題の重大度が判断されたら、カスタマーポータルからサービスリクエストを Connect オプションまたは https://access.redhat.com/support/contact/technicalSupport.html から提出します。サービスリクエストを送信するには、Red Hat ログインの詳細が必要なことに注意してください。

重大度がレベル 1 または 2 の場合は、呼び出し先のサービスリクエストに従います。連絡先情報と営業時間は https://access.redhat.com/support/contact/technicalSupport.html を参照してください。

プレミアムサブスクリプションをお持ちの場合は、重大度 1 と 2 ケースで、営業時間後にサポートが利用可能になります。

プレミアムサブスクリプションと標準のサブスクリプションの両方については、https://access.redhat.com/support/offerings/production/sla.html に掲載されています。

問題が適切に処理されていない、または適切に処理されていない場合は、エスカレートできます。エスカレーションには 2 つのタイプがあります。

コンタクトを含むエスカレーションの詳細は、https://access.redhat.com/support/policy/mgt_escalation.html から入手できます。

終了したサービス要求 (問題の再発生など) に関する詳細情報がある場合は、https://access.redhat.com/support/policy/mgt_escalation.html の Red Hat カスタマーポータルにアクセスするか、ローカルサポートセンターまでお電話いただくことで、リクエストを再度開くことができます。詳細は https://access.redhat.com/support/contact/technicalSupport.html を参照してください。

詳細は、以下の資料を参照してください。

オンラインドキュメント