ラベル GCC の投稿を表示しています。 すべての投稿を表示
ラベル GCC の投稿を表示しています。 すべての投稿を表示

2015年6月26日金曜日

gccコマンドで引数-lを使ってリンクするときの注意点と、実行ファイルとライブラリの依存関係

例えば、次のような「test.c」というファイルがある場合。
log10(x)はmath.hをインクルードしなければ使えない関数である。

#include <stdio.h>
#include <math.h>

void main() {
    double x = 100;
    x = log10(x);
      printf("%f\n",x);
    return ;
}

これを端末で次のようにコンパイルしようとすると、
gcc -o test test.c
以下のエラーが出て失敗する。
 `log10' に対する定義されていない参照です
これは必要なライブラリとのリンクができなかったために起こる。

なので、引数-lを使って使うライブラリを指定する必要がある。
ここではlibm.aが必要なので次のどちらかのようにしてコンパイルすると、エラーは出ない。
 gcc -o test test.c -lm
 gcc test.c -lm -o test

ただし、順番を変えて次の場合はエラーが出て失敗する。
 gcc -o test -lm test.c
 gcc -lm -o test test.c 
 gcc -lm test.c -o test

一応、オブジェクトファイルを作ってから試してみたが、結果は同じ。
test.cよりも-lmが後に無いとダメらしい。
読み込んだ順番に処理するため、libm.aより後に読み込まれたものは関数が組み込まれないんだとか。(GCCコマンド・オプションのリンク処理用のオプションを参照。)

私のように「引数-lm入れればいいんでしょ〜」ぐらいの感覚で使ってしまうと、ドツボにハマるので気をつけましょう・・・・


ライブラリのことを調べていたら、依存関係を調べるコマンドを発見。
実行ファイルのライブラリの依存関係を調べるにはlddコマンドを利用するらしい。
ldd -v xxxx xxxxは実行ファイルオプション-vは詳細情報の追加
とすることで、リンクしている共有ライブラリを検索できる。

試した結果。
$ ldd test
linux-gate.so.1 =>  (0xb77cd000)
libm.so.6 => /lib/i386-linux-gnu/libm.so.6 (0xb7771000)
libc.so.6 => /lib/i386-linux-gnu/libc.so.6 (0xb75c3000)
/lib/ld-linux.so.2 (0xb77d0000)


意味しているところは、testを実行するにあたり、
linux-gate.so.1
libm.so.6
libc.so.6
/lib/ld-linux.so.2
という共有ライブラリが必要であり、「=>」の後のパスは実際にリンクされたライブラリ。

「リンクさせたのはlibm.aじゃなかったの?」と思ってライブラリの場所を、
 sudo find / -name "libm.a" -ls
で探してみたら
 /usr/lib/i386-linux-gnu/libm.a
にあった。ARアーカイブらしい。
同じディレクトリに共有ライブラリlibm.soのリンクも発見。上記のアドレスはそのリンク元の模様。
何らかの処理でこうなっているのだろうが、よくわからん。

ちなみに、lddでコマンドは/binディレクトリに入って調べると、各コマンドに必要なライブラリを調べることができるようだ。

2015年6月23日火曜日

GCCのまとめ

GCCについて
C言語でgccを使ったコンパイル① GCC導入とコンパイル時のエラーについて
C言語でgccを使ったコンパイル② インクルードとリンクについて基礎知識
C言語でgccを使ったコンパイル③ gccコマンドの基本的な使い方
C言語でgccを使ったコンパイル④ pkg-configの利用

gccコマンドで引数-lを使ってリンクするときの注意点と、実行ファイルとライブラリの依存関係


エラーについて
undefined reference to `ほにゃらら'

C言語でgccを使ったコンパイル④ pkg-configの利用

gccコマンドのディレクトリを参照するための引数は直接入力しようとすると非常に長い場合がある。
さらに、環境によって異なる場合がある。

そこで、コマンド置換を利用したpkg-configが便利

例えばgccの引数として利用する場合、以下のようにバッククオートで囲んでやる。
 gcc xxxx.c `pkg-config --cflags --libs gtk+-3.0`
すると、gccコマンドよりも先にバッククオートで囲まれた部分がコマンドライン上で実行され、その結果が置き換わってgccの引数として利用できる。

前回、恐ろしく長い引数だったのが、これだけで済むのは素晴らしい。
NetBeansのようなIDEを利用している場合にもこれを指定するオプションがあるので、利用すると便利。


引数は
--cflags -I(ヘッダファイル)に対応した引数を返す
--libs  -l(ライブラリ)に対応した引数を返す
を意味している。

gtk+-3.0の部分は.pc ファイル名。
pkg-configは予め登録された拡張子.pc ファイルをもとにして情報を返している。
ライブラリによってはpkg-configに対応しておらず、自動的に.pcが作られない場合もあるためすべてのライブラリで使えるわけではない。

私の場合、拡張子.pcのあるディレクトリを
 sudo find / -name "*.pc" -ls
で確認すると、以下のディレクトリの下でが見つかった。
/usr/share/pkgconfig/
/usr/lib/pkgconfig/
/usr/lib/i386-linux-gnu/pkgconfig/



ちなみにgdk-3.0はここだった。
/usr/lib/i386-linux-gnu/pkgconfig/gdk-3.0.pc
中身は以下の通り。
prefix=/usr
exec_prefix=${prefix}
libdir=/usr/lib/i386-linux-gnu
includedir=${prefix}/include
targets=x11 wayland

gtk_binary_version=3.0.0
gtk_host=i686-pc-linux-gnu

Name: GTK+
Description: GTK+ Graphical UI Library
Version: 3.10.8
Requires: gdk-3.0 atk cairo cairo-gobject gdk-pixbuf-2.0 gio-2.0
Requires.private: atk atk-bridge-2.0 pangoft2 gio-unix-2.0
Libs: -L${libdir} -lgtk-3 
Cflags: -I${includedir}/gtk-3.0 

直接.pcファイルを編集したり、環境変数を変更して参照するディレクトリを変更したりといったこともできるらしい。

pkg-config(今日覚えた呪文)

コマンド置換と言われる方法はバッククオートで囲む以外にも
 $(pkg-config --cflags --libs gtk+-3.0)
としても結果は同じ。こちらの方法ではネストできるのが違うところ。

C言語でgccを使ったコンパイル③ gccコマンドの基本的な使い方


詳細な使い方は以下を参照。
コンパイラ(gccコマンド)の使い方

gccの使い方
GCCコマンド・オプション


自分用にまとめてみると基本のパターンは次のようになる。

実行ファイルを作成する
 gcc -o yyyy xxxx1.c xxxx2.c
xxxx1.cとxxxx2.cをコンパイル,リンクして,yyyyという実行ファイルを作成する。
例は2つのファイルだが、1つだけ、あるいは3つ以上も同様。
-o yyyyを省略すると自動的にa.outという実行ファイルになる。

オブジェクトファイルを作成する
 gcc -c xxxx.c
コンパイルしてxxxx.oというオブジェクトファイルを作成する。
実行ファイルを作成する場合とほぼ同様。

オブジェクトファイルをリンクして実行ファイルを作成する。
 gcc -o yyyy xxxx1.o xxxx2.o
xxxx1.oとxxxx2.oをリンクして、yyyy という実行ファイルを作成する。
こちらも上と同様。



インクルードするヘッダファイルの場所を追加
 gcc -I/home/myhome/lib xxxx.c 
ヘッダファイルを探すためのディレクトリを標準システムより先に追加

リンクするライブラリがあるディレクトリとライブラリを追加。
 gcc -L/home/myhome/lib xxxx.c -lzzzz
-Lで標準システムディレクトリに加えて/home/myhome/libをさがし、
-l(小文字のエル)でlibzzzz.aというライブラリとリンクを指定。
ライブラリ名前後の「lib」と「.a」が省略された形となる点に注意。


引数のまとめ
  • -c  コンパイルのみ
  • -o  実行結果のファイル名を-oの直後にくる文字列に指定。
  • -I (大文字のアイ)インクルードするヘッダファイルのあるディレクトリの追加。
  • -L  ライブラリを探すディレクトリを追加。
  • -l (小文字のエル)ライブラリの指定。

他にもあるが、ここでは割愛。
実行ファイルやオブジェクトファイルを作成するのは容易だが、GtkやSDLを利用する場合はヘッダファイルやライブラリが標準システムディレクトリ以外の場所にあるので、その場所を指定しなければならないため、引数がとても長くなる。

例えばSDLでは以下のサイトのサンプルをコンパイルしようとすると、
第268回 SDLで夢のオリジナルゲーム開発
 gcc -o sdltest sdltest.c -lSDL -lSDL_image -lSDL_ttf -lSDL_mixer
のようにディレクトリを複数指定する必要がある。

さらにGTK+3ではヘッダファイルとライブラリを含むディレクトリを調べるための引数はひと通り書き出すと以下の通り。
-I/usr/include/gtk-3.0
-I/usr/include/atk-1.0
-I/usr/include/at-spi2-atk/2.0
-I/usr/include/pango-1.0
-I/usr/include/gio-unix-2.0/
-I/usr/include/cairo
-I/usr/include/gdk-pixbuf-2.0
-I/usr/include/glib-2.0
-I/usr/lib/i386-linux-gnu/glib-2.0/include
-I/usr/include/harfbuzz
-I/usr/include/freetype2
-I/usr/include/pixman-1
-I/usr/include/libpng12
-lgtk-3
-lgdk-3
-latk-1.0
-lgio-2.0
-lpangocairo-1.0
-lgdk_pixbuf-2.0
-lcairo-gobject
-lpango-1.0
-lcairo
-lgobject-2.0
-lglib-2.0
うん、多すぎて扱いきれません。

これを簡単にするための方法は次回。

C言語でgccを使ったコンパイル① GCC導入とコンパイル時のエラーについて

GCCはGNU Compiler Collectionの略らしい。
CやC++、Fortran、Javaといったソースコードで書かれたファイルをコンパイルしてくれる。
おまけに必要な関数を定義したライブラリもついてくる。

コード自体は標準的なテキストファイルでも作成できるけれど、実行ファイルを作るならコンパイラは必要。

導入方法自体はネット上で調べればすぐに見つかるので割愛。
Linuxならソフトウェアセンターとかパッケージマネージャ、あるいは端末上からコマンドでも導入できる。

GNUのコンパイラ群がなんたらかんたらとWikiには書いてある。
GNUコンパイラコレクション
本家本元はこちら
GCC, the GNU Compiler Collection


問題は、実際のコンパイル時に出てくるエラーだ。
これがもうウンザリするほど出てくるんだよね・・・

色々と引数を設定したりする必要があるんだけれど、それもまた初心者にはわかりづらい。
とりあえず、エラーが出て意味がわからなかったらここのサイトが参考になるかもしれない。
http://www.c3.club.kyutech.ac.jp/~Krypton/kit_items/cc_error.html
C3(Composite Computer Club)のホームページ奥深くから見つけたのだが、日本語で説明してくれているので参考になるかも。

一番最初に引っかかったのがリンカーオプションの設定だった。
ココらへんの詳細はまたいつか更新する。かも?

C言語でgccを使ったコンパイル② インクルードとリンクについて基礎知識

GCCは何をしているのか?

作ったコードをコンパイルしてくれるgccというコマンド。

実際にはこのコマンド自体がコンパイルを行っているわけではなく、
内部で他のコマンドを呼び出して処理を行っている。
 gccコマンドは呼び出し屋さん gccコマンドの裏側
 コンパイラは何をしているのか

C言語の場合ではをgccを実行すると
 ccp プリプロセッサ
 cc1 アセンブリコードへ変換(C++ではcc1plus)
 as マシン語へ変換
 ld リンク処理
といった処理を経て実行ファイルが完成。


※コンパイルに使うコマンドでmakeというのもあるが、
こちらはMakefileの情報を素にソースファイルを組み合わせてコンパイルする。
その処理の中にgccのコマンドが利用されていたりする。


最初にC言語の標準ライブラリのみを使った単純なコードを作って遊んでいた時点ではあまり意識していなかった。
しかし、ソースファイルを分割した場合や、Gtk+やSDLといったライブラリを必要とするコードをコンパイルしようとすると少々ややこしくなる。
インクルードとリンクを処理するためにgccのコマンドに長い引数が必要となるからだ。

インクルードとは?

includeは「含める」という意味。
プリプロセッサによってその場に展開されてコードの一部として扱われる。
第27章 インクルード


C言語のコード中では先頭部分に
 #include <stdio.h>
 #include "xxxx.h"
のように書かれており、ヘッダファイルと呼ばれる。
ヘッダファイルには関数や変数の宣言が含まれており、これをインクルードすればそれら関数等を利用できるようになる。(関数の本体は別のファイルであるライブラリに含まれている。)
これにより、よく利用される処理を簡単に何度も使うことができ、ソースファイルの中身もスッキリとさせることができる。

例えば、C言語でよく利用される関数は予めC言語の標準ライブラリに定義されている。
printfやscanfといった文字の入出力を行う関数は予めインクルードしなければ利用することができず、stdio.hをインクルードすることで使えるようになる。

また、gccコマンドで引数なしで参照されるディレクトリは限られているので、それ以外の場所にあるものについては指定する必要がある。


リンク処理とは?

コンパイルされたオブジェクトファイルを組み合わせる処理。
ヘッダファイル中で参照されているライブラリや、分割作成したモジュール等を結合して実行可能なファイルを作る。

コンパイルとリンク
externとモジュール
C言語でヘッダファイルstdio.hのなかに・・・



そんなわけで・・・
自動で認識してくれるディレクトリ以外にあるヘッダファイルをインクルードする場合や、ライブラリをリンクする場合、どこを探せばそれがあるのかをgccに教えてやらなければならない。

実際のコンパイル時の引数は別記事にて。

2015年6月14日日曜日

undefined reference to `ほにゃらら'


GCCを使ってC言語のソースファイルをコンパイルした時に出るエラーの一つに

undefined reference to `ほにゃらら'(`ほにゃらら'に対する定義されていない参照です)

と出る場合がある。



使用した`ほにゃらら'という関数の定義が見つからないということなので、疑われるのは

  • 関数名の打ち間違い
  • インクルードするファイルが足りない

といったところ。


SDLを導入したばかりの頃、インクルードの仕組みや、コンパイルを全然理解していなかったので、
ネット上に落ちていたSDLを使ったコードを適当にコンパイルしようとして軽くハマった。


SDLやGTK+といったライブラリを利用したコードをコンパイルするには
それらをインストールするだけでなく、GCCのコマンドでオプションを設定してやる必要があるのだ。

例えばSDLならこんな感じで。
 gcc -o SDLtest SDLtest.c -lSDL -lSDL_image -lSDL_ttf -lSDL_mixer

詳細はまた追加するかも。