> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man8/service.8.md).

# service.8

`service` — 控制（启动/停止等）或列出系统服务

## 名称

`service`

## 概要

`service [-j jail] -e` `service [-j jail] [-q] -R` `service [-j jail] [-v] -l` `service [-j jail] [-v] -r` `service [-j jail] [-dqv] [-E var=value] script [command]`

## 描述

`service` 命令是 rc.d 系统的简易接口。其主要用途是启动和停止由 rc.d 脚本提供的服务。用于此目的时，它会设置与启动时使用的相同的受限环境（参见下文的 [环境变量](#环境变量)）。它还可用于根据各种条件列出脚本。

`command` 的可用值集合取决于所调用的特定 rc.d 脚本。有关大多数 rc.d 脚本支持的标准命令列表，请参见 [rc(8)](/man/man8/rc.8.md)。

可用选项如下：

**`-d`** 启用调试。

**`-E`** `var=value` 在启动脚本之前将环境变量 `var` 设置为指定的 `value`。此选项可多次使用。

**`-e`** 列出已启用的服务。待检查的脚本列表使用 [rcorder(8)](/man/man8/rcorder.8.md) 编译，方式与 [rc(8)](/man/man8/rc.8.md) 中相同，然后检查该脚本列表中是否存在 "rcvar" 赋值。如果存在，则检查脚本是否已启用。

**`-j`** `jail` 在指定的 jail 中执行给定操作。`jail` 参数可以是 jail ID 或 jail 名称。

**`-l`** 列出 **/etc/rc.d** 和本地启动目录中的所有文件。如 [rc.conf(5)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man5/rc.conf.5.md) 所述，这通常是 **/usr/local/etc/rc.d**。无论是否为实际的 rc.d 脚本，所有文件都会被列出。

**`-q`** 静默模式，将输出重定向到 **/dev/null**。

**`-R`** 重启所有已启用的本地服务。

**`-r`** 像上文的 `-e` 一样生成 [rcorder(8)](/man/man8/rcorder.8.md) 顺序，但列出所有文件，而不仅是已启用的文件。

**`-v`** 稍微更详细地输出。

## 环境变量

用于运行 rc.d 脚本时，`service` 命令将 `HOME` 设置为 **/**，将 `PATH` 设置为 **/sbin:/bin:/usr/sbin:/usr/bin**，与启动时在 **/etc/rc** 中的设置一致。如果使用了 `-E` 选项，则相应地设置对应的变量。

## 退出状态

`service` 工具成功时退出状态为 0，发生错误时大于 0。

## 实例

以下是一些最常见的 service 命令示例。有关大多数 rc.d 脚本中可用的完整命令列表，请参见 [rc(8)](/man/man8/rc.8.md)。

启用一个服务，然后启动它：

```sh
service sshd enable
service sshd start
```

停止一个服务，然后禁用它：

```sh
service sshd stop
service sshd disable
```

启动一个未启用的服务：

```sh
service sshd onestart
```

报告服务的状态：

```sh
service named status
```

重启在 jail 中运行的服务：

```sh
service -j dns named restart
```

以特定的环境变量启动服务：

```sh
service -E LC_ALL=C.UTF-8 named start
```

报告所有可用服务的详细列表：

```sh
service -rv
```

以下可编程补全条目可用于 [csh(1)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man1/csh.1.md) 中，用于 rc.d 脚本的名称和常用命令：

```sh
complete service 'c/-/(e l r v)/' 'p/1/`service -l`/' \
		 'n/*/(start stop reload restart \
		 status rcvar onestart onestop)/'
```

以下可编程补全条目可用于 bash(1)（`ports/shells/bash`）中，用于 rc.d 脚本的名称：

```sh
_service () {
	local cur
	cur=${COMP_WORDS[COMP_CWORD]}
	COMPREPLY=( $( compgen -W '$( service -l )' -- $cur ) )
	return 0
}
complete -F _service service
```

## 参见

bash(1)（`ports/shells/bash`）, [rc.conf(5)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man5/rc.conf.5.md), [rc(8)](/man/man8/rc.8.md), [rcorder(8)](/man/man8/rcorder.8.md), [sysrc(8)](/man/man8/sysrc.8.md)

## 历史

`service` 工具首次出现在 FreeBSD 7.3 中。

## 作者

本手册页由 Douglas Barton <dougb@FreeBSD.org> 编写。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man8/service.8.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.