{"componentChunkName":"component---src-templates-post-template-js","path":"/posts/where-are-c-header-files","result":{"data":{"markdownRemark":{"id":"14ef50d5-0816-592b-bbe3-adadb9418106","html":"

例えば Ruby や Python などで MySQL のクライアントライブラリを入れようとしたりすると、C 言語のヘッダファイル (<なんとか>.h) がないというエラーになったりすることがあります。

\n

そういった際はなんとなくググって解決できることも多いですが、根本的には必要なファイルを探す方法を身につけることが望ましいです。

\n

そこでこの記事には、

\n\n

について、自分に分かる範囲で書いていきます。

\n

検証環境

\n

まずは、検証環境について載せておきます。\n(Ubuntu 20.04 です)

\n
$ uname -a\nLinux oshima-desktop 5.13.0-52-generic #59~20.04.1-Ubuntu SMP Thu Jun 16 21:21:28 UTC 2022 x86_64 x86_64 x86_64 GNU/Linux\n$ gcc --version\ngcc (Ubuntu 9.4.0-1ubuntu1~20.04.1) 9.4.0\nCopyright (C) 2019 Free Software Foundation, Inc.\nThis is free software; see the source for copying conditions.  There is NO\nwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
\n

そもそも C 言語のヘッダファイルはどこにあるのか

\n

さて、それではまず前提として、C 言語のヘッダファイルがどこにあるのかから見ていきます。

\n

Google などで調べてみてもいいですが、「C 言語のコンパイル時にも参照されているはず」というアイデアで見てみようと思います。

\n

まずは C 言語のサンプルコードを作成します。

\n
#include <stdio.h>\n\nint main()\n{\n  printf(\"Hello world!\\n\");\n  exit(0);\n}
\n

gcc でコンパイルします。

\n

このとき、-v オプションで実行の詳細を表示してみます。

\n
$ gcc -o hello hello.c -v\nUsing built-in specs.\nCOLLECT_GCC=gcc\nCOLLECT_LTO_WRAPPER=/usr/lib/gcc/x86_64-linux-gnu/9/lto-wrapper\nOFFLOAD_TARGET_NAMES=nvptx-none:hsa\nOFFLOAD_TARGET_DEFAULT=1\nTarget: x86_64-linux-gnu\nConfigured with: ../src/configure -v --with-pkgversion='Ubuntu 9.4.0-1ubuntu1~20.04.1' --with-bugurl=file:///usr/share/doc/gcc-9/README.Bugs --enable-languages=c,ada,c++,go,brig,d,fortran,objc,obj-c++,gm2 --prefix=/usr --with-gcc-major-version-only --program-suffix=-9 --program-prefix=x86_64-linux-gnu- --enable-shared --enable-linker-build-id --libexecdir=/usr/lib --without-included-gettext --enable-threads=posix --libdir=/usr/lib --enable-nls --enable-clocale=gnu --enable-libstdcxx-debug --enable-libstdcxx-time=yes --with-default-libstdcxx-abi=new --enable-gnu-unique-object --disable-vtable-verify --enable-plugin --enable-default-pie --with-system-zlib --with-target-system-zlib=auto --enable-objc-gc=auto --enable-multiarch --disable-werror --with-arch-32=i686 --with-abi=m64 --with-multilib-list=m32,m64,mx32 --enable-multilib --with-tune=generic --enable-offload-targets=nvptx-none=/build/gcc-9-Av3uEd/gcc-9-9.4.0/debian/tmp-nvptx/usr,hsa --without-cuda-driver --enable-checking=release --build=x86_64-linux-gnu --host=x86_64-linux-gnu --target=x86_64-linux-gnu\nThread model: posix\ngcc version 9.4.0 (Ubuntu 9.4.0-1ubuntu1~20.04.1) \nCOLLECT_GCC_OPTIONS='-o' 'hello' '-v' '-mtune=generic' '-march=x86-64'\n /usr/lib/gcc/x86_64-linux-gnu/9/cc1 -quiet -v -imultiarch x86_64-linux-gnu hello.c -quiet -dumpbase hello.c -mtune=generic -march=x86-64 -auxbase hello -version -fasynchronous-unwind-tables -fstack-protector-strong -Wformat -Wformat-security -fstack-clash-protection -fcf-protection -o /tmp/cceK2Ql4.s\nGNU C17 (Ubuntu 9.4.0-1ubuntu1~20.04.1) version 9.4.0 (x86_64-linux-gnu)\n\tcompiled by GNU C version 9.4.0, GMP version 6.2.0, MPFR version 4.0.2, MPC version 1.1.0, isl version isl-0.22.1-GMP\n\nGGC heuristics: --param ggc-min-expand=100 --param ggc-min-heapsize=131072\nignoring nonexistent directory "/usr/local/include/x86_64-linux-gnu"\nignoring nonexistent directory "/usr/lib/gcc/x86_64-linux-gnu/9/include-fixed"\nignoring nonexistent directory "/usr/lib/gcc/x86_64-linux-gnu/9/../../../../x86_64-linux-gnu/include"\n#include "..." search starts here:\n#include <...> search starts here:\n /usr/lib/gcc/x86_64-linux-gnu/9/include\n /usr/local/include\n /usr/include/x86_64-linux-gnu\n /usr/include\nEnd of search list.\nGNU C17 (Ubuntu 9.4.0-1ubuntu1~20.04.1) version 9.4.0 (x86_64-linux-gnu)\n\tcompiled by GNU C version 9.4.0, GMP version 6.2.0, MPFR version 4.0.2, MPC version 1.1.0, isl version isl-0.22.1-GMP\n\nGGC heuristics: --param ggc-min-expand=100 --param ggc-min-heapsize=131072\nCompiler executable checksum: c0c95c0b4209efec1c1892d5ff24030b\nhello.c: In function ‘main’:\nhello.c:6:3: warning: implicit declaration of function ‘exit’ [-Wimplicit-function-declaration]\n    6 |   exit(0);\n      |   ^~~~\nhello.c:6:3: warning: incompatible implicit declaration of built-in function ‘exit’\nhello.c:2:1: note: include ‘<stdlib.h>’ or provide a declaration of ‘exit’\n    1 | #include <stdio.h>\n  +++ |+#include <stdlib.h>\n    2 | \nCOLLECT_GCC_OPTIONS='-o' 'hello' '-v' '-mtune=generic' '-march=x86-64'\n as -v --64 -o /tmp/ccolkcv4.o /tmp/cceK2Ql4.s\nGNU アセンブラ バージョン 2.34 (x86_64-linux-gnu)、BFD バージョン (GNU Binutils for Ubuntu) 2.34 を使用\nCOMPILER_PATH=/usr/lib/gcc/x86_64-linux-gnu/9/:/usr/lib/gcc/x86_64-linux-gnu/9/:/usr/lib/gcc/x86_64-linux-gnu/:/usr/lib/gcc/x86_64-linux-gnu/9/:/usr/lib/gcc/x86_64-linux-gnu/\nLIBRARY_PATH=/usr/lib/gcc/x86_64-linux-gnu/9/:/usr/lib/gcc/x86_64-linux-gnu/9/../../../x86_64-linux-gnu/:/usr/lib/gcc/x86_64-linux-gnu/9/../../../../lib/:/lib/x86_64-linux-gnu/:/lib/../lib/:/usr/lib/x86_64-linux-gnu/:/usr/lib/../lib/:/usr/lib/gcc/x86_64-linux-gnu/9/../../../:/lib/:/usr/lib/\nCOLLECT_GCC_OPTIONS='-o' 'hello' '-v' '-mtune=generic' '-march=x86-64'\n /usr/lib/gcc/x86_64-linux-gnu/9/collect2 -plugin /usr/lib/gcc/x86_64-linux-gnu/9/liblto_plugin.so -plugin-opt=/usr/lib/gcc/x86_64-linux-gnu/9/lto-wrapper -plugin-opt=-fresolution=/tmp/cczXFzh6.res -plugin-opt=-pass-through=-lgcc -plugin-opt=-pass-through=-lgcc_s -plugin-opt=-pass-through=-lc -plugin-opt=-pass-through=-lgcc -plugin-opt=-pass-through=-lgcc_s --build-id --eh-frame-hdr -m elf_x86_64 --hash-style=gnu --as-needed -dynamic-linker /lib64/ld-linux-x86-64.so.2 -pie -z now -z relro -o hello /usr/lib/gcc/x86_64-linux-gnu/9/../../../x86_64-linux-gnu/Scrt1.o /usr/lib/gcc/x86_64-linux-gnu/9/../../../x86_64-linux-gnu/crti.o /usr/lib/gcc/x86_64-linux-gnu/9/crtbeginS.o -L/usr/lib/gcc/x86_64-linux-gnu/9 -L/usr/lib/gcc/x86_64-linux-gnu/9/../../../x86_64-linux-gnu -L/usr/lib/gcc/x86_64-linux-gnu/9/../../../../lib -L/lib/x86_64-linux-gnu -L/lib/../lib -L/usr/lib/x86_64-linux-gnu -L/usr/lib/../lib -L/usr/lib/gcc/x86_64-linux-gnu/9/../../.. /tmp/ccolkcv4.o -lgcc --push-state --as-needed -lgcc_s --pop-state -lc -lgcc --push-state --as-needed -lgcc_s --pop-state /usr/lib/gcc/x86_64-linux-gnu/9/crtendS.o /usr/lib/gcc/x86_64-linux-gnu/9/../../../x86_64-linux-gnu/crtn.o\nCOLLECT_GCC_OPTIONS='-o' 'hello' '-v' '-mtune=generic' '-march=x86-64'
\n

この中を見てみると、

\n
 /usr/lib/gcc/x86_64-linux-gnu/9/cc1 -quiet -v -imultiarch x86_64-linux-gnu hello.c -quiet -dumpbase hello.c -mtune=generic -march=x86-64 -auxbase hello -version -fasynchronous-unwind-tables -fstack-protector-strong -Wformat -Wformat-security -fstack-clash-protection -fcf-protection -o /tmp/cceK2Ql4.s
\n

という箇所で実際のコンパイラ (cc1) が実行されているようです。

\n

※ gcc は広義では「コンパイラ」ですが、実際には内部で狭義のコンパイラ (cc1) やアセンブラ (as)、リンカなど (collect2) を呼び出しており、「コンパイラドライバ」と呼ばれることもあるそうです。

\n

さて、cc1 の実行以降の出力を見てみると…

\n
#include "..." search starts here:\n#include <...> search starts here:\n /usr/lib/gcc/x86_64-linux-gnu/9/include\n /usr/local/include\n /usr/include/x86_64-linux-gnu\n /usr/include\nEnd of search list.
\n

ということで、#include の検索をしている箇所が見つかりました。

\n

ここに表示されているパスから、ヘッダファイルを探しているようですね。

\n

ls などで見てみると、たしかにヘッダファイルが見つかります。

\n

必要なヘッダファイルをインストールするには

\n

ここから、不足しているヘッダファイルを探してインストールする方法を書いていきます。

\n

例えば Ruby や Python などで MySQL のクライアントライブラリを使いたい場合に、C 言語のヘッダファイルがないというエラーになったりすることがあります。

\n

そんな例であれば、

\n
$ sudo apt install libmariadb-dev
\n

のようにして、libmariadb-dev などをインストールして解決することになります。

\n

これは、求められているヘッダファイルが libmariadb-dev に含まれているためです。

\n

libmariadb-dev に含まれているファイルは、以下のように見ることができます。

\n
$ dpkg -L libmariadb-dev \n/.\n/usr\n/usr/bin\n/usr/bin/mariadb_config\n/usr/include\n/usr/include/mariadb\n    :\n/usr/include/mariadb/mysql.h\n    :
\n

ということで、libmariadb-dev をインストールすると、やはり /usr/include 以下にヘッダファイルが配置されるようですね。

\n

本来はこれとは逆で、あるヘッダファイルを含むパッケージを知りたいはずです。

\n

apt-file コマンドを使うことで、指定したヘッダファイルを含むパッケージを検索できます。

\n
$ apt-file search mysql.h\n    :\nlibgdal-doc: /usr/share/doc/libgdal-doc/gdal/drv_mysql.html\nlibgearman-doc: /usr/share/doc/libgearman-doc/html/gearmand/queues/mysql.html\nlibmariadb-dev: /usr/include/mariadb/mysql.h\nlibmariadb-dev: /usr/include/mariadb/server/mysql.h\nlibmariadb-dev: /usr/include/mariadb/server/private/probes_mysql.h\nlibmysqlclient-dev: /usr/include/mysql/mysql.h\nlibodb-api-dev: /usr/include/x86_64-linux-gnu/mysql.h\n    :
\n

mysql.h と検索してみましたが、libmariadb-dev 以外にも大量のパッケージが見つかりました。

\n

おわりに

\n

以上、C 言語のヘッダファイルの在り処と、「<なんとか>.h」がないというエラーへの対応について見てきました。

\n

このあたりは個人的になんとなくやっていた部分があるので、もっと知識をつけていこうと思います。

\n

関連書籍

\n

リンカ・ローダ実践開発テクニック

\n

\"\"

","fields":{"slug":"/posts/where-are-c-header-files","tagSlugs":["/tag/linux/","/tag/c/"],"autoRecommendPosts":["what-is-installation","what-is-executing-a-command-on-bash","command-collection-for-binary-files","linux-next-step-books"]},"frontmatter":{"date":"2022-07-10T14:58:42.419Z","description":"例えば Ruby や Python などで MySQL のクライアントライブラリを入れようとしたりすると、C 言語のヘッダファイル (<なんとか>.h) がないというエラーになったりすることがあります。\nそういった際はなんとなくググって解決できることも多いですが、根本的には必要なファイルを探す方法を身につけることが望ましいです。\nそこでこの記事には、C 言語のヘッダファイルがどこにあるのか、「<なんとか>.h」をインストールする方法、について、自分に分かる範囲で書いていきます。","tags":["linux","c"],"title":"C 言語のヘッダファイルの在り処と、「<なんとか>.h」がないというエラーへの対応について","socialImage":null,"recommendPosts":null}}},"pageContext":{"slug":"/posts/where-are-c-header-files"}},"staticQueryHashes":["251939775","3942705351","401334301"]}