undefined symbol 問題解決記錄


歷經一個月,昨日完成打印機network部分的編寫(c語言),編寫makefile構建動態庫。構建完成后遂進行調用測試,出現:

./network: symbol lookup error: /usr/lib64/netPrnctl.so: undefined symbol: cupsGetDests

將解決方法與過程記錄,以便日后查閱。

查找與分析原因

在編譯時未出現問題,沒有報錯,成功編譯生成動態庫。以下為編譯的makefile文件。

###########################################################
#    File:    netPrnctl.so Makefile
#    Author: Neko
###########################################################

CC = gcc
CFLAGS = -Wall -g -fPIC

INCLUDE = -I./inc -I../ -I../cups -I../backend -I/usr/include/libusb-1.0
TARGET = netPrnctl.so

vpath % .h ./inc

OBJS    = public.o prnctlAvision.o prnctlNetwork.o prnctl.o
SRCS    = ./src/public.c ./src/prnctlAvision.c ./src/prnctlNetwork.c ./src/prnctl.c

$(OBJS):$(SRCS)
    $(CC) $(CFLAGS) $(INCLUDE) -c $^

all:$(OBJS)
    $(CC) -shared -fPIC -o $(TARGET) $(OBJS) -pthread
    cp $(TARGET) /usr/bin
    cp $(TARGET) /usr/lib64

clean:
    rm -f *.o
    rm -f netPrnctl.so

 

雖成功生成了動態庫,但是在調用時卻出現找不到符號的問題,於是使用 ldd -r 查看

neko@neko:~/ZCPrinterDevice/NetworkSetupTool/filter$ ldd -r /usr/lib64/netPrnctl.so
    linux-vdso.so.1 (0x00007ffeef44c000)
    libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007f9607add000)
    libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f96076ec000)
    /lib64/ld-linux-x86-64.so.2 (0x00007f9607f0f000)
undefined symbol: libusb_open    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsArrayNew    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsDirOpen    (/usr/lib64/netPrnctl.so)
undefined symbol: ppdFindAttr    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsParseOptions    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsGetPPD    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_set_interface_alt_setting    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_release_interface    (/usr/lib64/netPrnctl.so)
undefined symbol: ppdClose    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsGetOption    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_detach_kernel_driver    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_close    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsFreeOptions    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsDirClose    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_get_string_descriptor_ascii    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_free_config_descriptor    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_get_config_descriptor    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsBackChannelWrite    (/usr/lib64/netPrnctl.so)
undefined symbol: _cupsGet1284Values    (/usr/lib64/netPrnctl.so)
undefined symbol: _ppdNormalizeMakeAndModel    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_attach_kernel_driver    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_get_device_list    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_kernel_driver_active    (/usr/lib64/netPrnctl.so)
undefined symbol: _cups_strcasecmp    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_bulk_transfer    (/usr/lib64/netPrnctl.so)
undefined symbol: _cupsLangPrintFilter    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsSideChannelRead    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsArrayCount    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsFileClose    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsDirRead    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_set_configuration    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsFreeDests    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_open_device_with_vid_pid    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_reset_device    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_exit    (/usr/lib64/netPrnctl.so)
undefined symbol: ppdOpenFile    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_init    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_get_device_descriptor    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsBackendReport    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_free_device_list    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_claim_interface    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsFileOpen    (/usr/lib64/netPrnctl.so)
undefined symbol: libusb_control_transfer    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsFileGets    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsArrayAdd    (/usr/lib64/netPrnctl.so)
undefined symbol: backendGetMakeModel    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsArrayFind    (/usr/lib64/netPrnctl.so)
undefined symbol: _cups_strlcpy    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsGetDests    (/usr/lib64/netPrnctl.so)
undefined symbol: cupsSideChannelWrite    (/usr/lib64/netPrnctl.so)
undefined symbol: httpAssembleURIf    (/usr/lib64/netPrnctl.so)

 

發現動態庫沒有鏈接libusb 與 libcups 兩個庫,所以netPrnctl.so用到的這兩個的函數都沒有符號。
雖然構建netPrnctl.so的c文件已包含libusb與cups函數的頭文件,編譯器做的工作僅是將源文件中以“文本形式”存在的源代碼翻譯成機器語言(二進制)的形式,並生成目標文件(源代碼全部變成"二進制"的形式),在此期間對源代碼中的語法進行檢查,有語法錯誤則報錯,程序無法通過編譯。故編譯沒有錯誤僅是說明沒有語法上的問題。在實際調用時也可能出現其他情況。
通過上面的makefile看到,編譯生成了

OBJS = public.o prnctlAvision.o prnctlNetwork.o prnctl.o

這4個目標文件。
而當鏈接器進行鏈接的時候,會先把各個目標文件在可執行文件(ELF文件的一種,共享庫也是屬於其中)里面的位置確定下來,然后經過一系列處理,直到把所有目標文件的內容都寫在可執行文件中對應的位置上,再經過一些工作,就會生成一個可執行程序。
由此判斷,netPrnctl.so依賴的libusb 與 libcups 兩個庫沒有鏈接上。

解決辦法

既然是因為沒有鏈接libusb 與 libcups,那么將這兩個庫鏈接上是不是就能解決問題?
首先查看這兩個庫的路徑。一般gcc里會有。

neko@neko:~/ZCPrinterDevice/NetworkSetupTool/filter$ ls /usr/lib/x86_64-linux-gnu/ | grep libcups
libcupscgi.so.1
libcupsfilters.so.1
libcupsfilters.so.1.0.0
libcupsimage.so.2
libcupsmime.so.1
libcupsppdc.so.1
libcups.so.2
neko@neko:~/ZCPrinterDevice/NetworkSetupTool/filter$ ls /usr/lib/x86_64-linux-gnu/ | grep libusb
libusb-1.0.a
libusb-1.0.so
libusbmuxd.so.4
libusbmuxd.so.4.0.0

 

於是將makefile進行調整,添加鏈接libusb 與 libcups的語句。

###########################################################
#    File:    netPrnctl.so Makefile
#    Author: Neko
###########################################################

CC = gcc
CFLAGS = -Wall -g -fPIC

INCLUDE = -I./inc -I../ -I../cups -I../backend -I/usr/include/libusb-1.0
TARGET = netPrnctl.so
LIBVAR = -lusb-1.0 -lcups
LIBPATH = -L/usr/lib64/x86_64-linux-gnu

vpath % .h ./inc

OBJS    = public.o prnctlAvision.o prnctlNetwork.o prnctl.o
SRCS    = ./src/public.c ./src/prnctlAvision.c ./src/prnctlNetwork.c ./src/prnctl.c

$(OBJS):$(SRCS)
    $(CC) $(CFLAGS) $(INCLUDE) -c $^

all:$(OBJS)
    $(CC) -shared -fPIC -o $(TARGET) $(OBJS) $(LIBPATH) $(LIBVAR) -pthread
    cp $(TARGET) /usr/bin
    cp $(TARGET) /usr/lib64

clean:
    rm -f *.o
    rm -f netPrnctl.so

 

編譯時卻報錯

/usr/bin/ld: 找不到 -lcups

這里說一下:
出現 /usr/bin/ld: cannot find(找不到) -lxxx
xxx表示函式庫文件名稱,如:libc.so、libltdl.so、libXtst.so。

命名規則是:lib+庫名(即xxx)+.so。

會發生這樣的原因有以下三種情形:

1 系統沒有安裝相對應的lib

2 相對應的lib版本不對

3 lib(.so檔)的symbolic link不正確,沒有連結到正確的函式庫文件(.so)

而libcups.so.2不符合命名規則。故報錯找不到。
解決辦法:
到libcups所在路徑下,鏈接新的符合規則的libcups.so

neko@neko:~/ZCPrinterDevice/NetworkSetupTool/filter$ cd  /usr/lib/x86_64-linux-gnu
neko@neko:/usr/lib/x86_64-linux-gnu$ sudo ln -s libcups.so.2 libcups.so
neko@neko:/usr/lib/x86_64-linux-gnu$ cd -
/home/neko/ZCPrinterDevice/NetworkSetupTool/filter
neko@neko:~/ZCPrinterDevice/NetworkSetupTool/filter$ ls /usr/lib/x86_64-linux-gnu/ | grep libcups
libcupscgi.so.1
libcupsfilters.so.1
libcupsfilters.so.1.0.0
libcupsimage.so.2
libcupsmime.so.1
libcupsppdc.so.1
libcups.so
libcups.so.2

 

重新編譯成功,沒有報錯。再次調用測試,也沒有出現找不到符號的問題。

neko@neko:~/ZCPrinterDevice/NetworkSetupTool/filter$ ldd -r /usr/lib64/netPrnctl.so
    linux-vdso.so.1 (0x00007fff43f66000)
    libusb-1.0.so.0 => /lib/x86_64-linux-gnu/libusb-1.0.so.0 (0x00007f4087f39000)
    libcups.so.2 => /usr/lib/x86_64-linux-gnu/libcups.so.2 (0x00007f4087cad000)
    libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007f4087a8e000)
    libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f408769d000)
    libudev.so.1 => /lib/x86_64-linux-gnu/libudev.so.1 (0x00007f408747f000)
    libgssapi_krb5.so.2 => /usr/lib/x86_64-linux-gnu/libgssapi_krb5.so.2 (0x00007f4087234000)
    libgnutls.so.30 => /usr/lib/x86_64-linux-gnu/libgnutls.so.30 (0x00007f4086ecf000)
    libavahi-common.so.3 => /usr/lib/x86_64-linux-gnu/libavahi-common.so.3 (0x00007f4086cc3000)
    libavahi-client.so.3 => /usr/lib/x86_64-linux-gnu/libavahi-client.so.3 (0x00007f4086ab2000)
    libz.so.1 => /lib/x86_64-linux-gnu/libz.so.1 (0x00007f4086895000)
    libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007f40864f7000)
    /lib64/ld-linux-x86-64.so.2 (0x00007f4088364000)
    librt.so.1 => /lib/x86_64-linux-gnu/librt.so.1 (0x00007f40862ef000)
    libkrb5.so.3 => /usr/lib/x86_64-linux-gnu/libkrb5.so.3 (0x00007f4086019000)
    libk5crypto.so.3 => /usr/lib/x86_64-linux-gnu/libk5crypto.so.3 (0x00007f4085de7000)
    libcom_err.so.2 => /lib/x86_64-linux-gnu/libcom_err.so.2 (0x00007f4085be3000)
    libkrb5support.so.0 => /usr/lib/x86_64-linux-gnu/libkrb5support.so.0 (0x00007f40859d8000)
    libp11-kit.so.0 => /usr/lib/x86_64-linux-gnu/libp11-kit.so.0 (0x00007f40856a9000)
    libidn2.so.0 => /usr/lib/x86_64-linux-gnu/libidn2.so.0 (0x00007f408548c000)
    libunistring.so.2 => /usr/lib/x86_64-linux-gnu/libunistring.so.2 (0x00007f408510e000)
    libtasn1.so.6 => /usr/lib/x86_64-linux-gnu/libtasn1.so.6 (0x00007f4084efb000)
    libnettle.so.6 => /usr/lib/x86_64-linux-gnu/libnettle.so.6 (0x00007f4084cc5000)
    libhogweed.so.4 => /usr/lib/x86_64-linux-gnu/libhogweed.so.4 (0x00007f4084a91000)
    libgmp.so.10 => /usr/lib/x86_64-linux-gnu/libgmp.so.10 (0x00007f4084810000)
    libdbus-1.so.3 => /lib/x86_64-linux-gnu/libdbus-1.so.3 (0x00007f40845c3000)
    libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007f40843bf000)
    libkeyutils.so.1 => /lib/x86_64-linux-gnu/libkeyutils.so.1 (0x00007f40841bb000)
    libresolv.so.2 => /lib/x86_64-linux-gnu/libresolv.so.2 (0x00007f4083fa0000)
    libffi.so.6 => /usr/lib/x86_64-linux-gnu/libffi.so.6 (0x00007f4083d98000)
    libsystemd.so.0 => /lib/x86_64-linux-gnu/libsystemd.so.0 (0x00007f4083b14000)
    liblzma.so.5 => /lib/x86_64-linux-gnu/liblzma.so.5 (0x00007f40838ee000)
    liblz4.so.1 => /usr/lib/x86_64-linux-gnu/liblz4.so.1 (0x00007f40836d2000)
    libgcrypt.so.20 => /lib/x86_64-linux-gnu/libgcrypt.so.20 (0x00007f40833b7000)
    libgpg-error.so.0 => /lib/x86_64-linux-gnu/libgpg-error.so.0 (0x00007f40831a2000)
 
可以看到,依賴的庫基本都鏈接上了。

結語

所有錯誤都有原因,有跡可循。遇到問題不要急躁,靜心思考,理出種種可能導致問題的原因,再排除,找到根源去解決。搜索引擎和書籍是很好的工具,凡事先盡量自己想辦法,獨立解決問題也是一種能力。
參加工作半年,此時的我也只是一個剛進門的初級工程師。這些話是對我自己的告誡,也是對與我一樣在門內探索的同學的建議,希望有所幫助。共勉。

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM