> 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/jls.8.md).

# jls.8

`jls` — 列出 jail

## 名称

`jls`

## 概要

`jls [--libxo] [-dhNnqsv] [-j jail] [parameter ...]`

`jls -c [-d] -j jail`

## 描述

`jls` 工具列出所有活动的 jail，或指定的 jail。每个 jail 由所列 `parameters` 的空格分隔值表示，每个 jail 一行（除非参数本身包含换行符）。伪参数 `all` 将显示所有可用的 jail 参数。可通过 `sysctl -d security.jail.param` 获取可用参数列表。有关一些核心参数的描述，请参见 [jail(8)](/man/man8/jail.8.md)。

如果未给出 `parameters` 或未给出 `-chns` 中的任何选项，将打印以下四列：jail 标识符（jid）、IP 地址（ip4.addr）、主机名（host.hostname）和路径（path）。

使用 `-c` 选项时，`jls` 不会产生任何输出（使用错误除外）。此模式仅用于检查单个 jail 是否存在，不接受任何 `parameter` 或打印选项标志。

可用选项如下：

**`--libxo`** 通过 libxo(3) 以多种人类和机器可读格式生成输出。有关命令行参数的详细信息，请参见 xo\_options(7)。

**`-c`** 仅检查 jail 是否存在。

**`-d`** 列出 `dying` 以及活动的 jail。

**`-h`** 打印包含所列参数的标题行。如果命令行上未给出参数，则假定为 `all`。

**`-N`** 在标准显示模式下，打印每个 jail 的名称而不是其数字 ID。如果 jail 没有名称，则打印数字 ID。

**`-n`** 以 "name=value" 格式打印参数，每个参数前有其名称。如果命令行上未给出参数，则假定为 `all`。

**`-q`** 如果参数包含空格或引号，或为空字符串，则在参数两侧加引号。

**`-s`** 打印适合传递给 [jail(8)](/man/man8/jail.8.md) 的参数，跳过只读和未使用的参数。隐含 `-nq`。

**`-v`** 用每个 jail 的多行摘要扩展标准显示，包含以下参数：jail 标识符（jid）、主机名（host.hostname）、路径（path）、jail 名称（name）、jail 状态（dying）、cpuset ID（cpuset）、IP 地址（ip4.addr 和 ip6.addr）。

**`-j`** `jail` 要列出的 `jail` 的 jid 或名称。未指定此选项时，将列出所有活动的 jail。

## 参见

jail\_get(2), libxo(3), xo\_options(7), [jail(8)](/man/man8/jail.8.md), [jexec(8)](/man/man8/jexec.8.md)

## 历史

`jls` 工具在 FreeBSD 5.1 中加入。可扩展的 jail 参数在 FreeBSD 8.0 中引入。libxo 支持在 FreeBSD 11.0 中加入。


---

# 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/jls.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.