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 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] [-o options]
pg_ctl unregister [-N servicename]
pg_ctl 是一个用于启动,停止, 或者重起 PostgreSQL 后端服务器(postmaster), 或者显示一个运行着的服务器的状态的工具, 尽管我们可以手动启动服务器,但是 pg_ctl 封装了重新定向日志输出, 与终端和进程组合理分离,以及另外提供了一个选项用于有控制的关闭。
在 start 模式里会启动一个新的服务器。 服务器是在后台启动的,标准输入被附着到了 /dev/null 上。如果使用了 -l,那么标准输出和标准错误被定向到一个日志文件, 要么就是重新定向到 pg_ctl 的标准输出(而不是标准错误)。 如果没有选定日志文件,pg_ctl 的标准输出应该重新定向到一个文件或者用管道输出类似 rotatelogs 这样的日志旋转程序,否则,postmaster 将把它的输出写到控制终端(在后台)并且将不会脱离 shell 的进程组。
在 stop 模式下,那个正在特定数据目录运行的服务器被关闭。 你可以用 -m 选项选择三种不同的关闭模式:"Smart" 模式等待所有客户端中断联接。 这个是缺省。"Fast" 模式并不等待客户端中断联接。 所有活跃事务都被回卷并且客户端都强制断开。 "Immediate" 模式将在没有干净关闭的情况下退出。这么做将导致在重新启动的时候的恢复。
restart 实际上是先执行一个停止,然后紧跟一个启动。它允许变换postmaster命令行的选项。
reload 模式简单地给postmaster发送一个 SIGHUP 信号,导致它重新读取她的配置文件 (postgresql.conf,pg_hba.conf 等等) 这样就允许修改配置文件选项而不用完全重启系统来使之生效。
status 模式监查一个服务器是否在指定的数据目录运行, 如果是,那么显示其 PID 和调用它的命令行选项。
kill 模式允许你给一个指定的进程发送信号。 这个功能对 Microsoft Windows 特别有用,因为那里没有 kill 命令。 使用 --help 查看支持的信号的名字的列表。
register 模式允许你在 Microsoft Windows 上注册一个系统服务。
unregister 模式允许你在 Microsoft Windows 上删除这个系统服务, 这个系统服务是前面用 register 命令注册的。
声明该数据库文件的文件系统位置。 如果忽略这个选项,使用环境变量 PGDATA。
把服务器日志输出附加在 filename 文件上。 如果该文件不存在,那么创建它。umask设置为 077, 因此缺省时是不允许从其它用户向日志文件访问的。
声明关闭模式。mode 可以是smart, fast, 或者 immediate,或者是这三个之一的第一个字母。
声明要直接传递给postmaster 的选项。
参数通常都用单或者双引号包围以保证它们作为一个整体传递。
声明 postmaster 可执行文件的位置。 缺省时 postmaster 是从和pg_ctl相同的目录取出,如果不是, 那么就是写死的安装目录。除非你想干点什么特别的事情,并且得到类似没有找到 postmaster这样的错误, 否则没有必要使用这个选项。
只打印错误,而不打印提示性信息。
等待启动或者关闭的完成。在 60 秒后超时。 这个参数是关闭时的缺省值。 成功的关闭是以删除 PID 文件为标志的。对于启动而言, 一次成功的 psql -l 就标志着成功。 pg_ctl 将视图使用对 psql 合适的端口,如果存在环境变量 PGPORT,那么用它。 否则,它将查找看看在 postgresql.conf 文件里面是否设置了一个端口。 如果都没有,它将使用 PostgreSQL 编译时的缺省端口(缺省是 5432)。 在等待的时候,pg_ctl 将根据启动或者关闭的成功状况返回一个准确的退出代码。
不等待启动或者停止的完成。这是启动和重起的缺省。
要注册的系统服务的名字。这个名字将用于服务名和显示名。
用户启动服务的口令。
用于启动服务的用户的用户名。对于域用户,使用 DOMAIN\username 格式。
这个文件存在于数据目录中是为了帮助 pg_ctl 判断服务器当前是否在运行。
如果这个文件存在于数据目录,pg_ctl(在 start 模式下)将把文件地内容当作传递给 postmaster 命令的选项传递过去,除非被 -o 选项覆盖。
如果这个文件存在于数据目录,pg_ctl(在start 模式下) 将把文件地内容当作传递给postmaster 命令的选项传递过去, 除非被 -o 选项覆盖。这个文件的内容也会在 status 模式里显示出来。
这个文件在数据目录中,会分析它以查找和 psql 一起用的合适的端口(在 start 模式里给出 -w 的时候。)
如果在数据目录里存在 postmaster.opts.default 文件,那么该文件将作为选项传递给 postmaster, 除非被 -o 选项覆盖。
启动服务器:
$ pg_ctl start
启动服务器的一个例子, 等到服务器 启动了才退出:
$ pg_ctl -w start
用于一个
postmaster 使用端口 5433,而且不带
fsync
运行,使用:
$ pg_ctl -o "-F -p 5433" start