Provided by:
manpages-zh_1.5.1-1_all 
NAME
ecpg - 嵌入的 SQL C 預處理器
SYNOPSIS
ecpg [ option... ] file...
DESCRIPTIONyz
ecpg 是一荋O入的用於C 語言的 SQL 預編譯器。 它把嵌有 SQL 語句的 C
程式通過將 SQL 調用替換成特殊的函數調用的方法轉換成普通的 C 代碼。
然後輸出的檔案就可以用任何 C 編譯工具進行處理。
clusterdb 將把命令行上給出的每蚇擗J檔案轉換成對應的 C 輸出檔案。
輸入檔案最好有 .pgc 的擴展名, 這樣,這蚋X展將被替換成 .c
來決定輸出檔名。 如果輸入檔案的擴展不是
.pgc,那麼輸出檔名將通過在全檔名後悸加 .c 來生成。 輸出檔名也可以用 -o
選項覆說C
本手冊隅瓣ㄣyz嵌入的 SQL 語句,參 Chapter 29 獲更多信息。
OPTIONS項
clusterdb 接受下列命令行參數:
-c 為 SQL 代碼自動生成某種 C 代碼。目前,這蚇龠等i以用於 EXEC SQL
TYPE。
-C mode
設置一茯萛e模式。mode 可以是 INFORMIX 或者 INFORMIX_SE。
-D symbol
定義一 C 預編譯器符號。
-i 同時也分析系統包含檔案。
-I include-path
聲明一茠加的包含路徑。用於尋找通過 EXEC SQL INCLUDE
包含的檔案。預設是 .(當前目錄), /usr/local/include,
在編譯時定義的PostgreSQL 包含路徑(預設:
/usr/local/pgsql/include)和 /usr/include。順序如上。
-o filename
聲明ecpg應該把它的所有輸出寫到給出的 filename裏。
-t 打開自動提交模式。在這種模式像,每茯d詢都自動提交,
除非它是包圍在一茤確的事務塊中。在預設模式下, 命令只是在發出
EXEC SQL COMMIT 的時埭ㄔ獢C
-v 列印額外的信息,包括版本和包含路徑。
--help 顯示一茤R令用法的簡單摘n,然後退出。
--version
顯示版本信息,然後退出。
NOTES`N
在編譯預處理的 C 代碼檔案的時唌A編譯器需n能夠找到 PostgreSQL
包含目錄裏悸 ECPG 頭檔案。因此,我怞b調用編譯器的時唹i能需n使用 -I
(比如,-I/usr/local/pgsql/include)。
使用了嵌入 SQL 的 C 代碼必須和 libecpg
庫鏈接,比如,使用這樣的鏈接選項: -L/usr/local/pgsql/lib -lecpg
這些目錄的實際i以通過 pg_config(1) 找到。
EXAMPLESl
如果你有一茈s prog1.pgc 的嵌入 SQL 的 C 鴝l碼,你可以用下-
悸漫R令序列創建一茈i執行程式:
ecpg prog1.pgc
cc -I/usr/local/pgsql/include -c prog1.c
cc -o prog1 prog1.o -L/usr/local/pgsql/lib -lecpg
者
Postgresql <laser@pgsqldb.org>