《OpenBSD手册》apachectl命令

[leo]

apachectl命令
APACHECTL(8) OpenBSD系统管理员手册 APACHECTL(8)
名称
[INDENT]apachectl - Apache HTTP 服务器控制接口
[/INDENT]语法
[INDENT]apachectl command [...]
[/INDENT]描述
[INDENT]apachectl是一个Apache超文本传输协议(HTTP)服务器的前端。
它被设计为帮助管理员控制Apache的httpd进程的功能。
command可以是下列参数中的一个或多个:
configtest
[INDENT][INDENT]运行一个配置文件语法测试。它会从语法上分析配置文件，
并且告诉你 ``Syntax OK'' 或者对出现的语法错误提供详细
的信息。
[/INDENT][/INDENT]fullstatus
[INDENT][INDENT]显示由``mod_status''提供的一个服务器的全部状态。要让它正常工作，
你需要在你的服务器上启用mod_status，并且(至少)需要有一个基于文
本的浏览器，例如lynx(1)。这里的 URL 是指访问状态报告的地址，你
可以通过在apachectl脚本中编辑STATUSURL变量来设置这个地址。
[/INDENT][/INDENT]graceful
[INDENT][INDENT]通过发送一个SIGUSR1平稳地重新启动 httpd(8) 。如果服务器此时尚未运行，这个命令会启动它. 这个选项不同于通常重新启动的地方是当前已建立的链接不会被取消。 一个副作用是旧的log文件不会马上被关闭。 这意味着如果他被使用在一个轮替脚本中, 需要一个很长的延迟以便旧的log文件在被处理前已被关闭。 在初始化重启前这个命令会自动通过configtest检查配置文件以确保httpd不会死掉。
[/INDENT][/INDENT]help
[INDENT][INDENT]显示一串简短的帮助信息.
[/INDENT][/INDENT]restart
[INDENT][INDENT]通过发送一个SIGHUP信号重启启动 httpd(8) 。 如果httpd进程尚未启动，就启动它。在初始化重启前这个命令会自动通过configtest检查配置文件以确保httpd不会死掉。如果httpd运行在chroot的环境中 (OpenBSD默认情况下)，并且启用了第三方模块, 重新启动可能会因为路径不一致而失败。这时应该先完全的停止进程，然后在重新启动它。
[/INDENT][/INDENT]start
[INDENT][INDENT]启动 httpd(8). 如果该进程已经在运行中会出现一条警告信息，不会真的执行
的启动动作。
[/INDENT][/INDENT]startssl
[INDENT][INDENT]启用ssl的功能 httpd(8); 请参看ssl(8)以获取更多的信息。 如果该进程已经在
运行中会出现一条警告信息，不会真的执行的启动动作。
[/INDENT][/INDENT]status
[INDENT][INDENT]显示一个简短的状态报告。 和fullstatus选项类似，但是不包含当前正在服务的请求。
[/INDENT][/INDENT]stop
[INDENT][INDENT]停止 httpd(8).
[/INDENT][/INDENT]
apachectl工具 程序成功时会返回0, 而 >0 的值则表示失败. 退出时的返回值为:
0 —— 操作完全成功
2 —— 应用错误
3 —— httpd 不能启动
4 —— httpd 不能停止
5 —— httpd 在重启过程中不能启动
6 —— httpd 在重启过程中不能重新启动
7 —— httpd 在一个graceful重启过程中不能重新启动
8 —— 配置文件语法错误
当给定多个参数时, 仅报告最后一个错误。
[/INDENT]
也请参阅
httpd(8), ssl(8)
全套的有关httpd的文档在 /usr/share/doc/html/httpd/.
OpenBSD 4.6 June 7, 2008 2