.\" auto-generated by docbook2man-spec $Revision: 1.1 $
.TH "PG_CTL" "1" "2003-11-02" "Application" "PostgreSQL Server Applications"
.SH NAME
pg_ctl \- 啓動，停止和重啓 PostgreSQL 服務器

.SH SYNOPSIS
.sp
\fBpg_ctl\fR \fBstart\fR\fR [ \fR\fB-w \fR\fR]\fR\fR [ \fR\fB-s \fR\fR]\fR\fR [ \fR\fB-D \fIdatadir\fB \fR\fR]\fR\fR [ \fR\fB-l \fIfilename\fB \fR\fR]\fR\fR [ \fR\fB-o \fIoptions\fB \fR\fR]\fR\fR [ \fR\fB-p \fIpath\fB \fR\fR]\fR

\fBpg_ctl\fR \fBstop\fR\fR [ \fR\fB-W \fR\fR]\fR\fR [ \fR\fB-s \fR\fR]\fR\fR [ \fR\fB-D \fIdatadir\fB \fR\fR]\fR\fR [ \fR\fB-m \fR\fB s[mart]\fR | \fBf[ast]\fR | \fBi[mmediate]\fR\fB \fR\fR]\fR

\fBpg_ctl\fR \fBrestart\fR\fR [ \fR\fB-w \fR\fR]\fR\fR [ \fR\fB-s \fR\fR]\fR\fR [ \fR\fB-D \fIdatadir\fB \fR\fR]\fR\fR [ \fR\fB-m \fR\fB s[mart]\fR | \fBf[ast]\fR | \fBi[mmediate]\fR\fB \fR\fR]\fR\fR [ \fR\fB-o \fIoptions\fB \fR\fR]\fR

\fBpg_ctl\fR \fBreload\fR\fR [ \fR\fB-s \fR\fR]\fR\fR [ \fR\fB-D \fIdatadir\fB \fR\fR]\fR

\fBpg_ctl\fR \fBstatus\fR\fR [ \fR\fB-D \fIdatadir\fB \fR\fR]\fR
.SH "DESCRIPTION 描述"
.PP
\fBpg_ctl\fR 是一個用於啓動，停止， 或者重起 PostgreSQL 後端服務器（postmaster）， 或者顯示一個運行着的服務器的狀態的工具， 儘管我們可以手動啓動服務器，但是 pg_ctl 封裝了重新定向日誌輸出， 與終端和進程組合理分離，以及另外提供了一個選項用於有控制的關閉。
.PP
在 \fBstart\fR  模式裏會啓動一個新的服務器。 服務器是在後臺啓動的，標準輸入被附着到了 /dev/null  上。如果使用了 -l，那麼標準輸出和標準錯誤被定向到一個日誌文件， 要麼就是重新定向到 pg_ctl 的標準輸出（而不是標準錯誤）。 如果沒有選定日誌文件，pg_ctl 的標準輸出應該重新定向到一個文件或者用管道輸出到另外一個進程， 比如那些日誌旋轉程序，否則，postmaster 將把它的輸出寫到控制終端（在後臺）並且將不會脫離 shell 的進程組。
.PP
在 \fBstop\fR 模式下，那個正在特定數據目錄運行的服務器被關閉。 你可以用 -m 選項選擇三種不同的關閉模式："Smart" 模式等待所有客戶端中斷聯接。 這個是缺省。"Fast" 模式並不等待客戶端中斷聯接。 所有活躍事務都被回捲並且客戶端都強制斷開。 "Immediate" 模式將在沒有乾淨關閉的情況下退出。這麼做將導致在重新啓動的時候的恢復。
.PP
\fBrestart\fR 實際上是先執行一個停止，然後緊跟一個啓動。它允許變換 \fBpostmaster\fR 命令行的選項。
.PP
\fBreload\fR 模式簡單地給 \fBpostmaster\fR 發送一個 SIGHUP 信號，導致它重新讀取她的配置文件 （\fIpostgresql.conf\fR,
\fIpg_hba.conf\fR 等等） 這樣就允許修改配置文件選項而不用完全重啓系統來使之生效。
.PP
\fBstatus\fR 模式監查一個服務器是否在指定的數據目錄運行， 如果是，那麼顯示其 PID 和調用它的命令行選項。
.SH "OPTIONS 選項"
.PP
.TP
\fB-D \fIdatadir\fB\fR
 聲明該數據庫文件的文件系統位置。 如果忽略這個選項，使用環境變量 PGDATA。
.TP
\fB-l \fIfilename\fB\fR
 把服務器日誌輸出附加在 filename 文件上。 如果該文件不存在，那麼創建它。umask設置爲 077， 因此缺省時是不允許從其它用戶向日志文件訪問的。
.TP
\fB-m \fImode\fB\fR
 聲明關閉模式。mode  可以是smart, fast, 或者 immediate，或者是這三個之一的第一個字母。
.TP
\fB-o \fIoptions\fB\fR
 聲明要直接傳遞給 \fBpostmaster\fR  的選項。

 參數通常都用單或者雙引號包圍以保證它們作爲一個整體傳遞。
.TP
\fB-p \fIpath\fB\fR
 聲明 postmaster 可執行文件的位置。 缺省時 postmaster 是從和 pg_ctl 相同的目錄取出，如果不是， 那麼就是寫死的安裝目錄。除非你想幹點什麼特別的事情，並且得到類似沒有找到 postmaster這樣的錯誤， 否則沒有必要使用這個選項。
.TP
\fB-s\fR
 只打印錯誤，而不打印提示性信息。
.TP
\fB-w\fR
 等待啓動或者關閉的完成。在 60 秒後超時。 這個參數是關閉時的缺省值。 成功的關閉是以刪除 PID 文件爲標誌的。對於啓動而言， 一次成功的 \fBpsql -l\fR  就標誌着成功。 pg_ctl 將視圖使用對 psql 合適的端口，如果存在環境變量 PGPORT，那麼用它。 否則，它將查找看看在 postgresql.conf 文件裏面是否設置了一個端口。 如果都沒有，它將使用 PostgreSQL 編譯時的缺省端口（缺省是 5432）。
.TP
\fB-W\fR
 不等待啓動或者停止的完成。這是啓動和重起的缺省。
.PP
.SH "ENVIRONMENT 環境"
.TP
\fBPGDATA\fR
 缺省數據目錄位置
.TP
\fBPGPORT\fR
\fBpsql\fR(1) 的缺省端口（由 -w 選項使用）。
.PP
 其它的環境變量，參閱 \fBpostmaster\fR(1).
.PP
.SH "FILES 文件"
.TP
\fB\fIpostmaster.pid\fB\fR
 這個文件存在於數據目錄中是爲了幫助 pg_ctl  判斷服務器當前是否在運行。
.TP
\fB\fIpostmaster.opts.default\fB\fR
 如果這個文件存在於數據目錄，\fBpg_ctl\fR（在 \fBstart\fR 模式下）將把文件地內容當作傳遞給 \fBpostmaster\fR 命令的選項傳遞過去，除非被 \fB-o\fR 選項覆蓋。
.TP
\fB\fIpostmaster.opts\fB\fR
如果這個文件存在於數據目錄，\fBpg_ctl\fR（在 \fBstart\fR 模式下）將把文件地內容當作傳遞給 \fBpostmaster\fR 命令的選項傳遞過去，除非被 \fB-o\fR 選項覆蓋。這個文件的內容也會在 status  模式裏顯示出來。
.TP
\fB\fIpostgresql.conf\fB\fR
 這個文件在數據目錄中，會分析它以查找和 psql 一起用的合適的端口（在 start 模式裏給出 -w  的時候。）
.SH "NOTES 注意"
.PP
 等待完全啓動還不是一個定義得很完整的操作， 如果訪問控制設置爲本地客戶端在沒有手工交互的情況下不能訪問的話還可能會失效。（比如，口令認證）。
.SH "EXAMPLES 例子"
.SS "STARTING THE SERVER 啓動服務器"
.PP
 啓動服務器：
.sp
.nf
$ \fBpg_ctl start\fR
.sp
.fi
.PP
 啓動服務器的一個例子， 等到服務器 啓動了才退出：
.sp
.nf
$ \fBpg_ctl -w start\fR
.sp
.fi
.PP
 用於一個 postmaster 使用端口 5433，而且不帶 fsync 運行，使用：
.sp
.nf
$ \fBpg_ctl -o "-F -p 5433" start\fR
.sp
.fi
.SS "STOPPING THE SERVER 停止服務器"
.PP
.sp
.nf
$ \fBpg_ctl stop\fR
.sp
.fi
 停止服務器，使用 -m 開關允許我們控制如何把後端停下來。 -w等待服務器停止。-m 聲明後端的停止模式。
.SS "RESTARTING THE SERVER 重起服務器"
.PP
 這個命令幾乎等於先停止 postmaster  然後再啓動她，只不過 \fBpg_ctl\fR 保存並重新使用上一次運行 postmaster 的命令行參數。重起服務器的最簡單的方法是：
.sp
.nf
$ \fBpg_ctl restart\fR
.sp
.fi
.PP
 重起服務器，等待其停止和重起：
.sp
.nf
$ \fBpg_ctl -w restart\fR
.sp
.fi
.PP
 使用 5433 重起並且重起後關閉 fsync：
.sp
.nf
$ \fBpg_ctl -o "-F -p 5433" restart\fR
.sp
.fi
.SS "SHOWING THE SERVER STATUS 顯示服務器狀態"
.PP
 下面是來自 \fBpg_ctl\fR 的狀態輸出的例子：
.sp
.nf
$ \fBpg_ctl status\fR
pg_ctl: postmaster is running (pid: 13718)
Command line was:
/usr/local/pgsql/bin/postmaster '-D' '/usr/local/pgsql/data' '-p' '5433' '-B' '128'
.sp
.fi
 這是在重起模式裏使用的命令行。
.SH "SEE ALSO 參見"
.PP
\fBpostmaster\fR(1)
.SH "譯者"
.B Postgresql 中文網站
.B 何偉平 <laser@pgsqldb.org>
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR