NAME¶

SYNOPSIS¶

pg_ctl stop [ -W ] [ -s ] [ -D datadir ] [ -m s[mart] | f[ast] | i[mmediate] ]

pg_ctl restart [ -w ] [ -s ] [ -D datadir ] [ -m s[mart] | f[ast] | i[mmediate] ] [ -o options ]

pg_ctl reload [ -s ] [ -D datadir ]

pg_ctl status [ -D datadir ]

DESCRIPTION 描述¶

在 start 模式裏會啓動一個新的服務器。 服務器是在後臺啓動的，標準輸入被附着到了 /dev/null 上。如果使用了 -l，那麼標準輸出和標準錯誤被定向到一個日誌文件， 要麼就是重新定向到 pg_ctl 的標準輸出（而不是標準錯誤）。 如果沒有選定日誌文件，pg_ctl 的標準輸出應該重新定向到一個文件或者用管道輸出到另外一個進程， 比如那些日誌旋轉程序，否則，postmaster 將把它的輸出寫到控制終端（在後臺）並且將不會脫離 shell 的進程組。

在 stop 模式下，那個正在特定數據目錄運行的服務器被關閉。 你可以用 -m 選項選擇三種不同的關閉模式："Smart" 模式等待所有客戶端中斷聯接。 這個是缺省。"Fast" 模式並不等待客戶端中斷聯接。 所有活躍事務都被回捲並且客戶端都強制斷開。 "Immediate" 模式將在沒有乾淨關閉的情況下退出。這麼做將導致在重新啓動的時候的恢復。

restart 實際上是先執行一個停止，然後緊跟一個啓動。它允許變換 postmaster 命令行的選項。

reload 模式簡單地給 postmaster 發送一個 SIGHUP 信號，導致它重新讀取她的配置文件 （postgresql.conf, pg_hba.conf 等等） 這樣就允許修改配置文件選項而不用完全重啓系統來使之生效。

status 模式監查一個服務器是否在指定的數據目錄運行， 如果是，那麼顯示其 PID 和調用它的命令行選項。

OPTIONS 選項¶

-D datadir

聲明該數據庫文件的文件系統位置。 如果忽略這個選項，使用環境變量 PGDATA。

-l filename

把服務器日誌輸出附加在 filename 文件上。 如果該文件不存在，那麼創建它。umask設置爲 077， 因此缺省時是不允許從其它用戶向日志文件訪問的。

-m mode

聲明關閉模式。mode 可以是smart, fast, 或者 immediate，或者是這三個之一的第一個字母。

-o options

聲明要直接傳遞給 postmaster 的選項。

參數通常都用單或者雙引號包圍以保證它們作爲一個整體傳遞。

-p path

聲明 postmaster 可執行文件的位置。 缺省時 postmaster 是從和 pg_ctl 相同的目錄取出，如果不是， 那麼就是寫死的安裝目錄。除非你想幹點什麼特別的事情，並且得到類似沒有找到 postmaster這樣的錯誤， 否則沒有必要使用這個選項。

-s

只打印錯誤，而不打印提示性信息。

-w

等待啓動或者關閉的完成。在 60 秒後超時。 這個參數是關閉時的缺省值。 成功的關閉是以刪除 PID 文件爲標誌的。對於啓動而言， 一次成功的 psql -l 就標誌着成功。 pg_ctl 將視圖使用對 psql 合適的端口，如果存在環境變量 PGPORT，那麼用它。 否則，它將查找看看在 postgresql.conf 文件裏面是否設置了一個端口。 如果都沒有，它將使用 PostgreSQL 編譯時的缺省端口（缺省是 5432）。

-W

不等待啓動或者停止的完成。這是啓動和重起的缺省。

ENVIRONMENT 環境¶

PGDATA

缺省數據目錄位置

PGPORT

psql(1) 的缺省端口（由 -w 選項使用）。

其它的環境變量，參閱 postmaster(1).

FILES 文件¶

postmaster.pid

這個文件存在於數據目錄中是爲了幫助 pg_ctl 判斷服務器當前是否在運行。

postmaster.opts.default

如果這個文件存在於數據目錄，pg_ctl（在 start 模式下）將把文件地內容當作傳遞給 postmaster 命令的選項傳遞過去，除非被 -o 選項覆蓋。

postmaster.opts

如果這個文件存在於數據目錄，pg_ctl（在 start 模式下）將把文件地內容當作傳遞給 postmaster 命令的選項傳遞過去，除非被 -o 選項覆蓋。這個文件的內容也會在 status 模式裏顯示出來。

postgresql.conf

這個文件在數據目錄中，會分析它以查找和 psql 一起用的合適的端口（在 start 模式裏給出 -w 的時候。）

NOTES 注意¶

EXAMPLES 例子¶

$ pg_ctl start

$ pg_ctl -w start

$ pg_ctl -o "-F -p 5433" start

$ pg_ctl stop

$ pg_ctl restart

$ pg_ctl -w restart

$ pg_ctl -o "-F -p 5433" restart

$ pg_ctl status
pg_ctl: postmaster is running (pid: 13718)
Command line was:
/usr/local/pgsql/bin/postmaster '-D' '/usr/local/pgsql/data' '-p' '5433' '-B' '128'

SEE ALSO 參見¶

譯者¶

跋¶