使用 gcc 自製 C/C++ 靜態、共享與動態載入函式庫教學

這裡介紹如何使用 gcc 編譯器自己製作 C/C++ 靜態、共享與動態載入函式庫，讓程式碼可以更方便的重複使用。

在開發不同的程式時，如果有一些程式碼是重複會用到的話，就可以將其製作成獨立的函式庫，不僅維護上更方便，也可以方便其他專案或是開發者使用，以下介紹以 gcc 還有 ar 等工具製作靜態、共享與動態載入函式庫的步驟。

範例程式

這裡我們用一個很簡單的 C 語言函數來做示範，假設我們有一個計算總和的 sum 函數，不同的專案或開發者都會需要用到它，sum.c 的內容如下：

#include "sum.h"
double sum(double a, double b) {
  return a + b;
}

其對應的標頭檔（header file）sum.h 內容如下：

#ifndef __SUM_H__
#define __SUM_H__
double sum(double a, double b);
#endif

這是一個簡單的 main.c 使用範例，其內容如下：

#include <stdio.h>
#include "sum.h"
int main(int argc, char *argv[]) {
  double a = 2.6, b = 4.2, c;
  c = sum(a, b);
  printf("%.1f + %.1f = %.1f\n", a, b, c);
  return 0;
}

若就一般正常的編譯程序，我們會使用 gcc 直接編譯所有的 C 檔案，連結後產生執行檔：

gcc -o main main.c sum.c

執行之：

./main

2.6 + 4.2 = 6.8

如果 sum.c 的內容只有在這一個專案中會用到，那麼這樣直接編譯的做法是最簡單又省事的。

如果有其他的專案也會用到 sum.c 裡面函數的話，最直接的作法就是把 sum.c 與 sum.h 兩個原始碼檔案複製一份到新的專案中，然後也用同樣的編譯方式如法泡製，但是這樣的缺點有兩個，一個就是每次都要重新編譯 sum.c 的內容，比較量費時間，另外就是未來若要持續維護 sum.c 的內容時，就需要同時修改好多個副本，既容易出錯也很麻煩。

另外如果 sum.c 的程式碼有機密性的問題，也就是說只想讓別人用，但是不想給原始碼的時候，也沒辦法直接用這種方式處理。

靜態函式庫

靜態函式庫（static library）就是由一些物件檔案（object files）所構成的封裝檔，通常其檔案名稱都會以 lib 開頭，而副檔名則為 .a。

使用靜態連結函式庫的好處就是所有的程式都包裝在執行檔中，不會因為缺少函式庫的檔案而不能執行，不過缺點就是這樣的執行檔大小會比較大，而如果函式庫有更新的話，整個執行檔也要跟著重新編譯。

以下我們示範將 sum.c 的內容製作成一個靜態函式庫的步驟。

Step 1
編譯 sum.c 的程式碼：

gcc -c -o sum.o sum.c

Step 2
使用 ar 指令將 sum.o 打包成 libsum.a 這個靜態連結函式庫：

ar -rcs libsum.a sum.o

Step 3
使用 libsum.a 這個靜態連結函式庫：

gcc main.c -L. -lsum -o main_static

也可以直接把 libsum.a 這個靜態連結函式庫檔案放進去編譯：

gcc main.c libsum.a -o main_static

這樣就可以將 main.c 這個程式編譯成 main_static 這個執行檔，而在編譯的過程中就不需要 sum.c 這個原始碼的檔案。

使用靜態連結函式庫所編譯出來的執行檔可以獨立執行，不需要原本的 libsum.a 檔：

ldd main_static

	linux-vdso.so.1 =>  (0x00007fffb0d1a000)
	libc.so.6 => /lib64/libc.so.6 (0x00007f0411e46000)
	/lib64/ld-linux-x86-64.so.2 (0x00007f0412220000)

共享函式庫

共享函式庫（shared library）是在程式實際開始執行時，才會被載入的函式庫，執行檔本身與共享函式庫是分離的，這樣可以讓執行檔的大小比較小，而且未來共享函式庫在更新之後，執行檔也不需要重新編譯，而缺點則是執行檔在執行時就會需要共享函式庫的檔案，如果缺少了共享函式庫的檔案，就會無法執行。

共享函式庫的檔案通常也是以 lib 開頭，但是其副檔名則為 .so，以下是建立共享函式庫的步驟。

Step 1
編譯時加入 -fPIC 參數，產生共享函式庫所需要的 position independant code：

gcc -c -fPIC -o sum.o sum.c

Step 2
使用 gcc 建立共享函式庫：

gcc -shared -Wl,-soname,libsum.so.1 -o libsum.so.1.0.0 sum.o

這裡的 -Wl 是用來將一些參數設定傳給連結器（linker），所以之後的 -soname 等參數就是傳給連結器的參數。

-soname 指定為 libsum.so.1 是代表函式庫的名稱，以 lib 開頭，接著是自己取的名稱，最後加上 .so 與 version 版本號碼，這一個 version 版本號碼所代表的是函示庫的介面版本，如果介面有改變時就會增加 version 版本號碼，以維護相容性的問題。

而最後產生的實際檔案名稱也跟 soname 類似，不過後面多了 minor 與 release 版本號碼，中間的 minor 號碼是用於標示新增加的介面，而最後面的 release 號碼則是用於程式內容的修正（介面不變的情況）。

如果程式使用到這個共享函式庫，則在執行時就會依據 soname 所指定的名稱來尋找函式庫的檔案，如果想要看共享函式庫的 soname 屬性，可以使用 objdump 指令：

objdump -p libsum.so.1.0.0 | grep SONAME

  SONAME               libsum.so.1

建立好共享函式庫之後，要建立一個不含版本號碼的 .so 連結檔，gcc 在連結時所需要的函式庫檔案是這一個：

ln -s libsum.so.1.0.0 libsum.so

另外再建立一個執行時要用的連結檔：

ln -s libsum.so.1.0.0 libsum.so.1

使用共享函式庫來編譯執行檔：

gcc main.c -L. -lsum -o main_dynamic

或是這樣編譯也可以：

gcc main.c libsum.so -o main_dynamic

編譯完成後，要執行時需要指定 LD_LIBRARY_PATH：

LD_LIBRARY_PATH=. ./main_dynamic

2.6 + 4.2 = 6.8

這一個 main_dynamic 執行檔在執行時，會需要 libsum.so.1 這一個共享函式庫檔案：

LD_LIBRARY_PATH=. ldd main_dynamic

	linux-vdso.so.1 =>  (0x00007ffc5f1f7000)
	libsum.so.1 => ./libsum.so.1 (0x00007efd0148d000)
	libc.so.6 => /lib64/libc.so.6 (0x00007efd010b3000)
	/lib64/ld-linux-x86-64.so.2 (0x00007efd01690000)

動態載入函式庫

動態載入函式庫（dynamically loaded library）就類似 Windows 的 dll 檔，是等到程式真正要用到時才會載入函式庫，其實作方式是透過 DL 函式庫配合一般的共享函式庫來處理的，以下是將之前製作的 libsum.so.1 共享函式庫改為動態載入的範例。

#include <stdlib.h>
#include <stdio.h>
#include <dlfcn.h>
int main(int argc, char **argv) {
  void *handle;
  double (*sum)(double, double);
  char *error;

  // 動態開啟共享函式庫
  handle = dlopen ("libsum.so.1", RTLD_LAZY);
  if (!handle) {
    fputs (dlerror(), stderr);
    exit(1);
  }

  // 取得 sum 函數的位址
  sum = dlsym(handle, "sum");
  if ((error = dlerror()) != NULL)  {
    fputs(error, stderr);
    exit(1);
  }

  // 使用 sum 函數
  double a = 2.6, b = 4.2, c;
  c = sum(a, b);
  printf("%.1f + %.1f = %.1f\n", a, b, c);

  // 關閉共享函式庫
  dlclose(handle);
  return 0;
}

將這段程式碼儲存為 main_dl.c 之後，按照一般的方式進行編譯：

gcc main_dl.c -ldl -o main_dl

在使用上跟共享函式庫差不多，一樣要指定 LD_LIBRARY_PATH：

LD_LIBRARY_PATH=. ./main_dl

2.6 + 4.2 = 6.8

表面上看起來跟一般的共享函式庫類似，不過這種動態載入函式庫方式與共享函式庫有很大的不同，共享函式庫是在程式一開始執行時就要載入（不管實際上有沒有使用到），而動態載入函式庫的做法則是可以在真正需要用到時才載入（如果沒用到就可以不需要載入）。

參考資料：René Nyffenegger、TLDP、MURMURING