PostgreSQL7.0手冊(cè)-程序員手冊(cè) -46. 鏈接動(dòng)態(tài)鏈接的函數(shù)
2019-09-08 23:33:42
供稿:網(wǎng)友
第四十六章. 鏈接動(dòng)態(tài)鏈接的函數(shù)
內(nèi)容
Linux
DEC OSF/1
SunOS 4.x, Solaris 2.x 和 HP-UX
在你創(chuàng)建并注冊(cè)完用戶定義的函數(shù)后,你的工作就基本完成了.但是,Postgres 必須把實(shí)現(xiàn)你的函數(shù)的目標(biāo)碼(例如,一個(gè) .o 文件,或一個(gè)共享庫(kù))裝載進(jìn)來(lái).正如我們前面所說(shuō),Postgres 在運(yùn)行時(shí)根據(jù)需要把你的代碼裝入內(nèi)存.為了讓你的代碼能夠動(dòng)態(tài)裝載,你可能要把它們用一種特殊的方法編譯和鏈接-編輯它們.本章簡(jiǎn)單的介紹在你應(yīng)該怎樣進(jìn)行要求的編譯和鏈接,才能夠把你自定義的函數(shù)裝載到正在運(yùn)行的 Postgres 服務(wù)器里去.
如果你有特殊的問(wèn)題,我們希望你能好好讀一下 C 編譯器 cc(1),和鏈接器,ld(1) 的手冊(cè)頁(yè)(最好多讀幾便).另外,在回歸測(cè)試套件的目錄 PGROOT/src/regress 里包含這個(gè)過(guò)程的幾個(gè)工作樣本.如果你按照這些測(cè)試的例子做,你應(yīng)該沒(méi)有任何問(wèn)題.
會(huì)用到下面幾個(gè)術(shù)語(yǔ):
動(dòng)態(tài)裝載(Dynamic loading)是 Postgres 對(duì)一個(gè)目標(biāo)文件的操作.目標(biāo)文件被拷貝進(jìn)入運(yùn)行著的 Postgres 服務(wù)器中并且文件里的函數(shù)和變量可以被 Postgres 進(jìn)程內(nèi)的函數(shù)使用.Postgres 利用操作系統(tǒng)提供的動(dòng)態(tài)裝載的機(jī)制來(lái)實(shí)現(xiàn)這個(gè)目的.
裝載和鏈接編輯(Loading and link editing)是你為了生成某種其他類型的目標(biāo)文件對(duì)目標(biāo)文件做的處理(例如,一個(gè)可執(zhí)行程序或一個(gè)共享庫(kù)).你使用鏈接編輯程序,ld(1),來(lái)執(zhí)行這些操作.
下面的通用限制和注釋適用于后面的討論:
給創(chuàng)建函數(shù)命令的路徑必須是絕對(duì)路徑(也就是說(shuō),以 "/" 開(kāi)頭),該路徑指向一個(gè) Postgres 服務(wù)器運(yùn)行的機(jī)器上的該服務(wù)器可見(jiàn)的目錄.
小技巧:相對(duì)路徑實(shí)際上也可用,但卻是與數(shù)據(jù)庫(kù)存放的路徑(通常是前端應(yīng)用不可見(jiàn)的)相對(duì)的目錄.顯然,把路徑設(shè)為與用戶啟動(dòng)的前端應(yīng)用相對(duì)的路徑是沒(méi)有意義的.因?yàn)榉?wù)器可能是運(yùn)行在完全不同的機(jī)器上!
Postgres 用戶必須能夠訪問(wèn)賦予創(chuàng)建函數(shù)命令的路徑并且能夠讀取該目標(biāo)文件.這是因?yàn)椤ostgres 服務(wù)器以 Postgres 用戶的身份運(yùn)行,而不是以運(yùn)行前端進(jìn)程的用戶的身份運(yùn)行.(把文件或一個(gè)目錄的權(quán)限設(shè)成 "postgres" 用戶不能讀和/或不能執(zhí)行是一個(gè)極為常見(jiàn)的錯(cuò)誤.)
定義在目標(biāo)文件里的符號(hào)名一定不能互相沖突,或與定義在 Postgres 里的其他符號(hào)沖突.
GNU C 通常不提供利用操作系統(tǒng)的動(dòng)態(tài)鏈接器的接口的選項(xiàng).在這種情況下就必須使用操作系統(tǒng)附帶的 C 編譯器.
Linux
在 Linux ELF 里面,目標(biāo)文件可以通過(guò)聲明編譯選項(xiàng) -fpic 生成.
例如,
# simple Linux example
% cc -fpic -c foo.c
生成一個(gè)目標(biāo)文件 foo.o 就是可以動(dòng)態(tài)裝載入 Postgres.不需要進(jìn)行附加的裝載或者鏈接編輯工作.
--------------------------------------------------------------------------------
DEC OSF/1
在 DEC OSF/1 里,你可以用帶合適參數(shù)的 ld 命令把任何簡(jiǎn)單的目標(biāo)文件變成一個(gè)共享的目標(biāo)文件.此命令用起來(lái)象:
# simple DEC OSF/1 example
% cc -c foo.c
% ld -shared -expect_unresolved '*' -o foo.so foo.o
生成的共享文件馬上就可以裝載入 Postgres.當(dāng)為創(chuàng)建函數(shù)命令聲明目標(biāo)文件時(shí),我們必需給出共享文件的文件名(以 .so 結(jié)尾)而不是簡(jiǎn)單的目標(biāo)文件.
小技巧:實(shí)際上,對(duì)于共享目標(biāo)文件而言 Postgres 并不關(guān)心你給這個(gè)文件什么名稱.如果你喜歡把你的共享目標(biāo)文件命名成以 .o 結(jié)尾,對(duì) Postgres 而言是沒(méi)有問(wèn)題的,只要你保證你給創(chuàng)建函數(shù)命令的文件名也是正確的就行了.換而言之,你必須保持一貫.不過(guò),從務(wù)實(shí)的角度出發(fā),我們不建議這么做,因?yàn)槟愫苋菀讜?huì)把自己搞迷糊,不知道哪個(gè)文件是轉(zhuǎn)換過(guò)的共享文件,而哪一個(gè)不是.例如,如果目標(biāo)文件和共享文件都以 .o 結(jié)尾,你很難寫(xiě)一個(gè) Makefile 來(lái)做自動(dòng)連接編輯工作!
如果你聲明的文件不是共享文件,后端就會(huì)掛起!
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
DEC OSF/1
在 DEC OSF/1 里,你可以用帶合適參數(shù)的 ld 命令把任何簡(jiǎn)單的目標(biāo)文件變成一個(gè)共享的目標(biāo)文件.此命令用起來(lái)象:
# simple DEC OSF/1 example
% cc -c foo.c
% ld -shared -expect_unresolved '*' -o foo.so foo.o
生成的共享文件馬上就可以裝載入 Postgres.當(dāng)為創(chuàng)建函數(shù)命令聲明目標(biāo)文件時(shí),我們必需給出共享文件的文件名(以 .so 結(jié)尾)而不是簡(jiǎn)單的目標(biāo)文件.
小技巧:實(shí)際上,對(duì)于共享目標(biāo)文件而言 Postgres 并不關(guān)心你給這個(gè)文件什么名稱.如果你喜歡把你的共享目標(biāo)文件命名成以 .o 結(jié)尾,對(duì) Postgres 而言是沒(méi)有問(wèn)題的,只要你保證你給創(chuàng)建函數(shù)命令的文件名也是正確的就行了.換而言之,你必須保持一貫.不過(guò),從務(wù)實(shí)的角度出發(fā),我們不建議這么做,因?yàn)槟愫苋菀讜?huì)把自己搞迷糊,不知道哪個(gè)文件是轉(zhuǎn)換過(guò)的共享文件,而哪一個(gè)不是.例如,如果目標(biāo)文件和共享文件都以 .o 結(jié)尾,你很難寫(xiě)一個(gè) Makefile 來(lái)做自動(dòng)連接編輯工作!
如果你聲明的文件不是共享文件,后端就會(huì)掛起!
--------------------------------------------------------------------------------