pg_ctl start [-w] [-s] [-D datadir] [-l filename] [-o options] [-p path]
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 status [-D datadir]
pg_ctl 是一个用于启动,停止, 或者重起postmaster PostgreSQL 后端服务器,或者显示一个运行着的 postmaster 的状态的工具, 尽管我们可以手动启动 postmaster,但是 pg_ctl 封装了重新定向日志输出, 与终端和进程组合理分离,以及另外提供了一个选项用于有控制的关闭.
在 start 模式里会启动一个新的 postmaster. 服务器是在后台启动的,标准输入被附着到了 /dev/null 上.如果使用了 -l,那么标准输出和标准错误 被定向到一个日志文件,要么就是重新定向到 pg_ctl 的标准输出(而不是标准错误). 如果没有选定日志文件,pg_ctl 的标准输出 应该重新定向到一个文件或者用管道输出到另外一个进程,比如那些 日志旋转程序,否则,postmaster 将把它的输出写到控制终端(在后台) 并且将不会脱离 shell 的进程组.
在 stop 模式下,那个正在特定书局目录运行的 postmaster 被关闭.你可以用 -m 选项选择三种 不同的关闭模式∶“Smart” 模式等待所有客户端中断联接. 这个是缺省.“Fast” 模式并不等待客户端中断联接. 所由活跃事务都将回卷.“Immediate” 模式将在没有完全 关闭的情况下退出.这么做将导致在重新启动的时候的恢复. 缺省时,停止模式等待关闭动作的完成.
restart 实际上是先执行一个停止,然后紧跟一个 启动.它允许变换 postmaster 命令行的选项.
status 模式监查一个 postmaster 是否在运行, 如果是,那么显示其 PID 和调用它的命令行选项.
声明该数据库文件的文件系统位置. 如果忽略这个选项,使用环境变量 PGDATA.
把服务器日志输出附加在 filename 文件上. 如果该文件不存在,那么创建它.掩码设置为 077, 因此缺省时是不允许从其它用户向日志文件访问的.
声明关闭模式.mode 可以是smart, fast, 或者 immediate,或者是这三个之一的第一个字母.
声明要直接传递给postmaster 的选项.
参数通常都用单或者双引号包围以保证它们作为一个整体传递.
声明 postmaster 可执行文件的位置. 缺省时 postmaster 是从和 pg_ctl 相同的目录取出,如果不是, 那么九十写死的安装目录.除非你想干点什么特别的事情,并且 得到类似"没有找到 postmaster"这样的错误,否则没有必要使用 这个选项.
等待启动或者关闭的完成.在 60 秒后超时. 这个参数是关闭时的缺省值.
不等待启动或者停止的完成.这是启动和重起的缺省.
只打印错误,而不打印提示性信息.
启动 postmaster:
$ pg_ctl start
启动postmaster的一个例子, 等到 postmaster 启动了才退出:
$ pg_ctl -w start
用于一个 postmaster 使用端口 5433,而且不带 fsync 运行,使用:
$ pg_ctl -o "-F -p 5433" start