> 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/release/freebsd-9.3-release/9.3-errata.md).
# FreeBSD 9.3-RELEASE 勘误
## 摘要
本文列出 FreeBSD 9.3-RELEASE 的勘误项，包含发行后或在发行周期后期发现的、未能纳入发行版文档的重要信息。这些信息包括安全公告，以及与可能影响软件或文档运行或可用性相关的消息。在安装本版本 FreeBSD 之前，应始终查阅本文档的最新版本。
FreeBSD 9.3-RELEASE 的勘误文档将维护至 FreeBSD 9.3-STABLE 生命周期结束（EoL）。
## 引言
本勘误文档包含关于 FreeBSD 9.3-RELEASE 的“最新消息”。在安装本版本之前，务必查阅本文档，以了解可能在发布后已经发现并修复的问题。
随发行版实际分发的任何勘误文档副本（例如在 CDROM 发行版上）按定义均已过时，但其他副本在互联网上保持更新，应作为本发行版的“当前勘误”查阅。这些其他勘误副本位于 ，以及任何保持该位置最新镜像的站点。
FreeBSD 9.3-STABLE 的源代码和二进制快照也包含本文档的最新副本（截至快照生成时）。
所有 FreeBSD CERT 安全公告列表，请参阅 。
## 安全公告
以下安全公告中描述的问题已在 9.3-RELEASE 中修复。更多信息，请参阅 上提供的各个公告。
| 公告 | 日期 | 主题 |
| ---------------------------------------------------------------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [FreeBSD-SA-14:18.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:18.openssl.asc) | 2014 年 9 月 9 日 | 多个漏洞 |
| [FreeBSD-SA-14:19.tcp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:19.tcp.asc) | 2014 年 9 月 16 日 | TCP 数据包处理中的拒绝服务。 |
| [FreeBSD-SA-14:20.rtsold](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:20.rtsold.asc) | 2014 年 10 月 21 日 | 远程缓冲区溢出漏洞。 |
| [FreeBSD-SA-14:21.routed](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:21.routed.asc) | 2014 年 10 月 21 日 | 远程拒绝服务漏洞。 |
| [FreeBSD-SA-14:22.namei](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:22.namei.asc) | 2014 年 10 月 21 日 | 沙箱 namei 查找中的内存泄漏。 |
| [FreeBSD-SA-14:23.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:23.openssl.asc) | 2014 年 10 月 21 日 | 多个漏洞。 |
| [FreeBSD-SA-14:25.setlogin](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:25.setlogin.asc) | 2014 年 11 月 4 日 | 内核栈信息泄露。 |
| [FreeBSD-SA-14:26.ftp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:26.ftp.asc) | 2014 年 11 月 4 日 | 远程代码执行。 |
| [FreeBSD-SA-14:28.file](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:28.file.asc) | 2014 年 12 月 10 日 | [file(1)](https://man.freebsd.org/cgi/man.cgi?query=file\&sektion=1\&format=html) 和 [libmagic(3)](https://man.freebsd.org/cgi/man.cgi?query=libmagic\&sektion=3\&format=html) 中的多个漏洞 |
| [FreeBSD-SA-14:29.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:29.bind.asc) | 2014 年 12 月 10 日 | 远程拒绝服务漏洞 |
| [FreeBSD-SA-14:31.ntp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-14:31.ntp.asc) | 2014 年 12 月 23 日 | 多个漏洞 |
| [FreeBSD-SA-15:01.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:01.openssl.asc) | 2015 年 1 月 14 日 | 多个漏洞 |
| [FreeBSD-SA-15:02.kmem](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:02.kmem.asc) | 2015 年 1 月 27 日 | SCTP 内核内存损坏和泄露漏洞 |
| [FreeBSD-SA-15:03.sctp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:03.sctp.asc) | 2015 年 1 月 27 日 | SCTP 流重置漏洞 |
| [FreeBSD-SA-15:04.igmp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:04.igmp.asc) | 2015 年 2 月 25 日 | IGMP 协议中的整数溢出 |
| [FreeBSD-SA-15:05.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:05.igmp.asc) | 2015 年 2 月 25 日 | 远程拒绝服务漏洞 |
| [FreeBSD-SA-15:06.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:06.openssl.asc) | 2015 年 3 月 19 日 | 多个漏洞 |
| [FreeBSD-SA-15:07.ntp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:07.ntp.asc) | 2015 年 4 月 7 日 | 多个漏洞 |
| [FreeBSD-SA-15:09.ipv6](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:09.ipv6.asc) | 2015 年 4 月 7 日 | 路由器通告拒绝服务 |
| [FreeBSD-SA-15:10.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:10.openssl.asc) | 2015 年 6 月 16 日 | 多个漏洞 |
| [FreeBSD-SA-15:11.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:11.bind.asc) | 2015 年 7 月 7 日 | 解析器远程拒绝服务 |
| [FreeBSD-SA-15:13.tcp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:13.tcp.asc) | 2015 年 7 月 21 日 | 会话卡在 `LAST_ACK` 状态导致的资源耗尽。 |
| [FreeBSD-SA-15:15.tcp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:15.tcp.asc) | 2015 年 7 月 28 日 | TCP 重组中的资源耗尽 |
| [FreeBSD-SA-15:16.openssh](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:16.openssh.asc) | 2015 年 7 月 28 日 | 多个漏洞 |
| [FreeBSD-SA-15:17.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:17.bind.asc) | 2015 年 7 月 28 日 | 远程拒绝服务漏洞 |
| [FreeBSD-SA-15:19.routed](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:19.routed.asc) | 2015 年 8 月 5 日 | 远程拒绝服务漏洞 |
| [FreeBSD-SA-15:20.expat](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:20.expat.asc) | 2015 年 8 月 18 日 | 修复 [libbsdxml(3)](https://man.freebsd.org/cgi/man.cgi?query=libbsdxml\&sektion=3\&format=html) 中的多个整数溢出。 |
| [FreeBSD-SA-15:21.amd64](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:21.amd64.asc) | 2015 年 8 月 25 日 | 修复 IRET 处理程序中的本地权限提升。 |
| [FreeBSD-SA-15:22.openssh](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:22.openssh.asc) | 2015 年 8 月 25 日 | 多个漏洞 |
| [FreeBSD-SA-15:23.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:23.bind.asc) | 2015 年 9 月 2 日 | 远程拒绝服务漏洞 |
| [FreeBSD-SA-15:24.rpcbind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:24.rpcbind.asc) | 2015 年 9 月 29 日 | 远程拒绝服务 |
| [FreeBSD-SA-15:25.ntp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:25.ntp.asc) | 2015 年 10 月 26 日 | 多个漏洞 |
| [FreeBSD-SA-15:26.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:26.openssl.asc) | 2015 年 12 月 5 日 | 多个漏洞 |
| [FreeBSD-SA-15:27.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-15:27.bind.asc) | 2015 年 12 月 16 日 | 远程拒绝服务 |
| [FreeBSD-SA-16:01.sctp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:01.sctp.asc) | 2016 年 1 月 14 日 | ICMPv6 错误消息漏洞 |
| [FreeBSD-SA-16:02.ntp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:02.ntp.asc) | 2016 年 1 月 14 日 | Panic 阈值绕过漏洞 |
| [FreeBSD-SA-16:03.linux](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:03.linux.asc) | 2016 年 1 月 14 日 | 不正确的 `futex` 处理 |
| [FreeBSD-SA-16:04.linux](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:04.linux.asc) | 2016 年 1 月 14 日 | [setgroups(2)](https://man.freebsd.org/cgi/man.cgi?query=setgroups\&sektion=2\&format=html) 系统调用漏洞 |
| [FreeBSD-SA-16:05.tcp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:05.tcp.asc) | 2016 年 1 月 14 日 | MD5 签名拒绝服务 |
| [FreeBSD-SA-16:06.bsnmpd](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:06.bsnmpd.asc) | 2016 年 1 月 14 日 | 不安全的默认配置文件权限 |
| [FreeBSD-SA-16:07.openssh](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:07.openssh.asc) | 2016 年 1 月 14 日 | OpenSSH 客户端信息泄露 |
| [FreeBSD-SA-16:08.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:08.bind.asc) | 2016 年 1 月 27 日 | 远程拒绝服务漏洞。 |
| [FreeBSD-SA-16:09.ntp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:09.ntp.asc) | 2016 年 1 月 27 日 | 多个漏洞。 |
| [FreeBSD-SA-16:10.linux](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:10.linux.asc) | 2016 年 1 月 27 日 | [issetugid(2)](https://man.freebsd.org/cgi/man.cgi?query=issetugid\&sektion=2\&format=html) 系统调用漏洞。 |
| [FreeBSD-SA-16:11.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:11.openssl.asc) | 2016 年 1 月 30 日 | SSLv2 密码套件降级漏洞。 |
| [FreeBSD-SA-16:12.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:12.openssl.asc) | 2016 年 3 月 7 日 | 多个漏洞 |
| [FreeBSD-SA-16:13.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:13.bind.asc) | 2016 年 3 月 10 日 | 多个漏洞 |
| [FreeBSD-SA-16:14.openssh-xauth](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:14.openssh-xauth.asc) | 2016 年 3 月 16 日 | OpenSSH xauth 注入漏洞 |
| [FreeBSD-SA-16:15.sysarch](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:15.sysarch.asc) | 2016 年 3 月 16 日 | [sysarch(2)](https://man.freebsd.org/cgi/man.cgi?query=sysarch\&sektion=2\&format=html) 中的参数验证不正确 |
| [FreeBSD-SA-16:09.ntp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:09.ntp.asc) | 2016 年 4 月 29 日 | 多个 ntp 漏洞。 |
| [FreeBSD-SA-16:17.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:17.openssl.asc) | 2016 年 4 月 29 日 | 多个 OpenSSL 漏洞。 |
| [FreeBSD-SA-16:18.atkbd](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:18.atkbd.asc) | 2016 年 5 月 17 日 | 键盘驱动缓冲区溢出 |
| [FreeBSD-SA-16:19.sendmsg](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:19.sendmsg.asc) | 2016 年 5 月 17 日 | [sendmsg(2)](https://man.freebsd.org/cgi/man.cgi?query=sendmsg\&sektion=2\&format=html) 中的参数处理不正确 |
| [FreeBSD-SA-16:20.linux](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:20.linux.asc) | 2016 年 5 月 31 日 | Linux 兼容层中的内核栈信息泄露 |
| [FreeBSD-SA-16:21.43bsd](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:21.43bsd.asc) | 2016 年 5 月 31 日 | 4.3BSD 兼容层中的内核栈信息泄露 |
| [FreeBSD-SA-16:22.libarchive](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:22.libarchive.asc) | 2016 年 5 月 31 日 | 绝对路径遍历漏洞 |
| [FreeBSD-SA-16:23.libarchive](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:23.libarchive.asc) | 2016 年 5 月 31 日 | 绝对路径遍历漏洞 |
| [FreeBSD-SA-16:24.ntp](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:24.ntp.asc) | 2016 年 6 月 3 日 | 多个 ntp 漏洞 |
| [FreeBSD-SA-16:25.bspatch](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:25.bspatch.asc) | 2016 年 7 月 25 日 | 堆溢出漏洞 |
| [FreeBSD-SA-16:26.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:26.openssl.asc) | 2016 年 9 月 23 日 | 多个漏洞 |
| [FreeBSD-SA-16:27.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:27.openssl.asc) | 2016 年 9 月 26 日 | OpenSSL 套件中的回归 |
| [FreeBSD-SA-16:28.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:28.bind.asc) | 2016 年 10 月 10 日 | BIND 拒绝服务 |
| [FreeBSD-SA-16:29.bspatch](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:29.bspatch.asc) | 2016 年 10 月 10 日 | 堆溢出漏洞 |
| [FreeBSD-SA-16:30.portsnap](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:30.portsnap.asc) | 2016 年 10 月 10 日 | 多个漏洞 |
| [FreeBSD-SA-16:31.libarchive](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:31.libarchive.asc) | 2016 年 10 月 10 日 | 多个漏洞 |
| [FreeBSD-SA-16:34.bind](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:34.bind.asc) | 2016 年 11 月 2 日 | 远程拒绝服务漏洞 |
| [FreeBSD-SA-16:35.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:35.openssl.asc) | 2016 年 11 月 2 日 | 远程拒绝服务漏洞 |
| [FreeBSD-SA-16:36.telnetd](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:36.telnetd.asc) | 2016 年 12 月 6 日 | 可能的 [login(1)](https://man.freebsd.org/cgi/man.cgi?query=login\&sektion=1\&format=html) 参数注入 |
| [FreeBSD-SA-16:37.libc](https://www.FreeBSD.org/security/advisories/FreeBSD-SA-16:37.libc.asc) | 2016 年 12 月 6 日 | [link\_ntoa(3)](https://man.freebsd.org/cgi/man.cgi?query=link_ntoa\&sektion=3\&format=html) 缓冲区溢出 |
## 勘误通知
| 勘误 | 日期 | 主题 |
| ------------------------------------------------------------------------------------------------------------------ | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| [FreeBSD-EN-14:10.tzdata](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-14:10.tzdata.asc) | 2014 年 10 月 21 日 | 时区数据文件更新 |
| [FreeBSD-EN-14:11.crypt](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-14:11.crypt.asc) | 2014 年 10 月 21 日 | 将 [crypt(3)](https://man.freebsd.org/cgi/man.cgi?query=crypt\&sektion=3\&format=html) 默认哈希算法改回 DES |
| [FreeBSD-EN-14:12.zfs](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-14:12.zfs.asc) | 2014 年 11 月 11 日 | 修复 NFSv4 和 ZFS 缓存一致性问题 |
| [FreeBSD-EN-14:13.freebsd-update](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-14:13.freebsd-update.asc) | 2014 年 12 月 23 日 | 修复 [freebsd-update(8)](https://man.freebsd.org/cgi/man.cgi?query=freebsd-update\&sektion=8\&format=html) 中的目录删除问题 |
| [FreeBSD-EN-15:01.vt](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:01.vt.asc) | 2015 年 2 月 25 日 | [vt(4)](https://man.freebsd.org/cgi/man.cgi?query=vt\&sektion=4\&format=html) 因不当 ioctl 参数崩溃 |
| [FreeBSD-EN-15:02.openssl](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:02.openssl.asc) | 2015 年 2 月 25 日 | OpenSSL 更新 |
| [FreeBSD-EN-15:03.freebsd-update](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:03.freebsd-update.asc) | 2015 年 2 月 25 日 | [freebsd-update(8)](https://man.freebsd.org/cgi/man.cgi?query=freebsd-update\&sektion=8\&format=html) 以非最优顺序更新库 |
| [FreeBSD-EN-15:04.freebsd-update](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:04.freebsd-update.asc) | 2015 年 5 月 13 日 | [freebsd-update(8)](https://man.freebsd.org/cgi/man.cgi?query=freebsd-update\&sektion=8\&format=html) 未确保上一次升级已完成 |
| [FreeBSD-EN-15:06.file](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:06.file.asc) | 2015 年 6 月 9 日 | 多个拒绝服务问题 |
| [FreeBSD-EN-15:08.sendmail](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:08.sendmail.asc) | 2015 年 6 月 30 日（修订） | Sendmail TLS/DH 互操作性改进 |
| [FreeBSD-EN-15:09.xlocale](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:09.xlocale.asc) | 2015 年 6 月 30 日 | 修复 locale 和 rune locale 状态之间的不一致 |
| [FreeBSD-EN-15:15.pkg](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:15.pkg.asc) | 2015 年 8 月 25 日 | 对支持的 [pkg(7)](https://man.freebsd.org/cgi/man.cgi?query=pkg\&sektion=7\&format=html) 签名方法检查不足。 |
| [FreeBSD-EN-15:18.pkg](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:18.pkg.asc) | 2015 年 9 月 16 日 | 为 [pkg(7)](https://man.freebsd.org/cgi/man.cgi?query=pkg\&sektion=7\&format=html) 引导实现 `pubkey` 支持。 |
| [FreeBSD-EN-15:19.kqueue](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:19.kqueue.asc) | 2015 年 11 月 4 日 | [kqueue(2)](https://man.freebsd.org/cgi/man.cgi?query=kqueue\&sektion=2\&format=html) 写事件对大于 2GB 的文件从不触发。 |
| [FreeBSD-EN-15:20.vm](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-15:20.vm.asc) | 2015 年 11 月 4 日 | 应用程序因正确内存地址上的段错误而退出。 |
| [FreeBSD-EN-16:02.pf](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-16:02.pf.asc) | 2016 年 1 月 14 日 | 无效 TCP 校验和问题。 |
| [FreeBSD-EN-16:03.yplib](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-16:03.yplib.asc) | 2016 年 1 月 14 日 | YP/NIS 库缺陷。 |
| [FreeBSD-EN-16:08.zfs](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-16:08.zfs.asc) | 2016 年 5 月 4 日 | ZFS 中的内存泄漏 |
| [FreeBSD-EN-16:09.freebsd-update](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-16:09.freebsd-update.asc) | 2016 年 7 月 25 日 | 修复 [freebsd-update(8)](https://man.freebsd.org/cgi/man.cgi?query=freebsd-update\&sektion=8\&format=html) 对 FreeBSD 11.0-RELEASE 的支持 |
| [FreeBSD-EN-16:19.tzcode](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-16:19.tzcode.asc) | 2016 年 12 月 6 日 | 修复关于无效时区缩写的警告 |
| [FreeBSD-EN-16:20.tzdata](https://www.FreeBSD.org/security/advisories/FreeBSD-EN-16:20.tzdata.asc) | 2016 年 12 月 6 日 | 更新时区数据库信息 |
## 最新消息
无最新消息。
---
# 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/release/freebsd-9.3-release/9.3-errata.md?ask=&goal=
```
`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.