pg_ctl start [-w] [-t seconds] [-s] [-D datadir] [-l filename] [-o options] [-p path] [-c]
pg_ctl stop [-W] [-t seconds] [-s] [-D datadir] [-m
s[mart] | f[ast] | i[mmediate]
]
pg_ctl restart [-w] [-t seconds] [-s] [-D datadir] [-c] [-m
s[mart] | f[ast] | i[mmediate]
] [-o options]
pg_ctl reload [-s] [-D datadir]
pg_ctl status [-D datadir]
pg_ctl kill [signal_name] [process_id]
pg_ctl register [-N servicename] [-U username] [-P password] [-D datadir] [-w] [-t seconds] [-o options]
pg_ctl unregister [-N servicename]
pg_ctlはPostgreSQLのバックエンドサーバ（postgres）を起動、停止、再起動する、あるいは稼働中のサーバの状態を表示するためのユーティリティです。 サーバは手動で起動することも可能ですが、pg_ctlは、ログ出力のリダイレクトや、ターミナルとプロセスグループの適切な分離などの作業をカプセル化してくれます。 さらにシャットダウン制御のための便利なオプションも提供します。
startモードでは、新しいサーバが立ち上がります。 サーバはバックグラウンドで起動され、標準入力は/dev/nullに接続されます。 標準出力と標準エラーは、（-lオプションが使われた場合）ログファイルに追加されます。 そうでない場合はpg_ctlの標準出力（標準エラー出力ではありません）にリダイレクトされます。 ログファイルを指定しない場合、pg_ctlの標準出力は、ファイルにリダイレクトするか、例えばrotatelogsなどのログ回転プログラムのような別プロセスにパイプで渡すべきです。 そうしないと、postgresは出力を（バックグラウンドから）制御端末に書き出すので、シェルのプロセスグループから切り離すことができません。
stopモードは、指定されたデータディレクトリで稼働しているサーバを停止（シャットダウン）します。 -mオプションでは、3つの異なる停止方式を選択できます。 "Smart"モードは全てのクライアントが切断するまで待ちます。 これがデフォルトです。 "Fast"モードはクライアントが切断するまで待ちません。 全ての実行中のトランザクションをロールバックし、クライアントとの接続を強制的に切断した後、サーバを停止します。 "Immediate"モードは、クリーンアップ処理なしで、全てのサーバプロセスを中断します。 これを指定すると、再起動時に回復処理が実行されます。
restartモードは、効果的にサーバを停止して、その後、再起動します。 この時、postgresコマンドラインオプションを変更することができます。
reloadモードは、単にpostmasterにSIGHUPシグナルを送り、（postgresql.conf、pg_hba.confなどの）設定ファイルを再読み込みを実行させます。 これにより、完全な再起動をすることなく、設定ファイルのオプションの変更を反映させることができます。
statusモードは指定したデータディレクトリでサーバが起動しているかどうかを確認します。 起動している場合はPIDと、サーバを起動する時に使われたコマンドラインオプションを表示します。
killモードでは指定したプロセスにシグナルを送信することができます。 これは特に、killコマンドを持たないMicrosoft Windowsで有用です。 サポートするシグナル名の一覧は--helpを使用して確認してください。
registerモードにより、Microsoft Windows上でシステムサービスを登録することができます。
unregisterにより、過去にregisterコマンドにより登録された、Microsoft Windows上のシステムサービスを登録解除することができます。
実現可能なプラットフォームにおいて、サーバクラッシュ時にcoreファイルを生成できるように関連するソフトリソース制限を上げます。 障害が起きたサーバプロセスから得られたスタックトレースを行うことができますので、問題のデバッグや診断の際に有用です。
データベースファイルのファイルシステム上の場所を指定します。 これが省略された場合、PGDATA環境変数が使われます。
サーバログ出力をfilenameに追加します。 そのファイルが存在しない場合は作成されます。 umaskは077に設定されるため、他のユーザからのログファイルへのアクセスはデフォルトでは許可されません。
停止（シャットダウン）モードを指定します。 modeはsmart、fast、immediate、もしくはこの3つのモード名の最初の1文字をとることができます。
直接postgresに渡されるオプションを指定します。
このオプションは、通常、1グループとして渡されることを保証するために、単一引用符または二重引用符で囲まれます。
postgresの実行プログラムの位置を指定します。 デフォルトではpostgresの実行プログラムはpg_ctlと同じディレクトリにあるものと仮定されます。また、このディレクトリに存在しなければ、構築時に指定したインストールディレクトリが使われます。 このオプションは、何か異例なことをしていてpostgresが見つからないというようなエラーが出ない限り、使う必要はありません。
エラーメッセージのみを表示し、その他の情報を表示しません。
起動または停止の待機が完了するまでの秒数。
起動もしくは停止処理が完了するのを待ちます。 デフォルトの待機時間は60秒です。 停止（シャットダウン）処理のデフォルトです。 停止が成功したかどうかは、PIDファイルが削除されているかどうかによってわかります。 起動はpsql -lが成功するかどうかによって確認できます。 pg_ctlはpsqlに適切なポートを使用しようとします。 PGPORT環境変数が指定されていれば、それが使用されます。 さもなければ、postgresql.confファイルでポートが設定されていないかどうかを確認します。 どちらも設定されていない場合は、PostgreSQLのコンパイル時のデフォルトのポートが使用されます（デフォルトは5432）。 待機している間、pg_ctlは、起動もしくは停止が成功したかどうかに基づいて正しい終了コードを返します。
起動もしくは停止が完了するのを待ちません。 起動と再起動のデフォルトです。
デフォルトのデータ保存場所です。
psql用のデフォルトポートです（-wオプションで使用されます）。
この他のサーバ変数についてはpostgresを参照してください。 また、このユーティリティは、他のほとんどのPostgreSQLユーティリティと同様、libpqでサポートされる環境変数を使用します（項30.12を参照してください）。
データディレクトリにこのファイルがあるかどうかによって、pg_ctlはサーバが現在稼働中か否かを決定します。
このファイルがデータディレクトリにあれば、pg_ctl（のstartモード）は、-oで上書きされるものを除き、このファイルの内容をオプションとしてpostgresに渡します。
このファイルがデータディレクトリにあれば、pg_ctl（のrestartモード）は、-oで上書きされるものを除き、このファイルの内容をオプションとしてpostgresに渡します。 また、このファイルの内容がstatusモードで表示されます。
データディレクトリに置かれるこのファイルは、startモードで-wが使用された時にpsqlで使用する適切なポートを見つけるために解析されます。
完全な起動を行うまでの待機操作は、十分に設計されていません。アクセス制御の設定として、ローカルクライアントから対話的に操作を行わなければ接続できないようになっている場合は失敗する可能性があります（パスワード認証が必要な場合など）。 この他の接続用変数については、項30.12を参照してください。 また、パスワードについては項30.13も参照してください。
サーバを起動します。
$ pg_ctl start
以下はサーバが立ち上がるまで待機する起動例です。
$ pg_ctl -w start
ポート5433を使いfsyncなしでサーバを起動します。
$ pg_ctl -o "-F -p 5433" start