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