Provided by: manpages-zh_1.5.1-2_all bug

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>