> 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/ask/flat/readme.md). # FreeBSD Ask ![🎉 Welcome to the world of BSD!](/files/ApRHkhHMxCtmQsZulAiJ) 🎉 Welcome to the world of BSD! FreeBSD is a truly free (Liberty) **operating system** that, in this unpredictable world, still upholds the BSD UNIX philosophy — **abiding by ancient principles, pursuing true freedom**. ## Summary > **Note** > > The material before you corresponds to the third Chinese edition. This book is an open-source research work about the FreeBSD operating system. [~~The FreeBSD project is about to be Archived~~ — to protect our beloved operating system... what we can do is, write a book!](https://www.bilibili.com/bangumi/media/md3068) (Adapted from the iconic slogan in Love Live! School Idol Project\[Z]. Japan: SUNRISE, 2013-01-06) ## About the Authors This book is co-authored by multiple members of the Chinese FreeBSD Community (CFC). ![WeChat Official Account](/files/k2TbQEq5jNOpab3TzR8X) WeChat Official Account: bsdcn2018 * The primary contact for the Chinese FreeBSD Community (CFC) is the QQ group: [787969044](https://qm.qq.com/q/cX5mpJ36gg) ![Chinese FreeBSD Community (CFC) QQ Group](/files/mnoj5QgDHQ7SJr2YzvOa) * WeChat group: Due to WeChat platform restrictions, you must first join the QQ group, then contact the group owner to obtain the latest group QR code. * **Discord**: (Requires a proxy; accessible via the web client) * **Telegram**: (Requires a proxy) ## Electronic Documents This book provides electronic documents in both PDF and EPUB formats: * PDF (suitable for printing and offline desktop reading) download link: ![PDF file status](https://img.shields.io/website?url=https%3A%2F%2Fdocs.bsdcn.org%2Fbsdbook.pdf\&up_message=%E6%96%87%E4%BB%B6%E5%8F%AF%E7%94%A8\&down_message=%E6%96%87%E4%BB%B6%E4%B8%8D%E5%8F%AF%E7%94%A8\&style=for-the-badge\&label=%E6%96%87%E6%A1%A3%E7%8A%B6%E6%80%81) * EPUB (suitable for offline mobile reading) download link: ![EPUB file status](https://img.shields.io/website?url=https%3A%2F%2Fdocs.bsdcn.org%2Fbsdbook.epub\&up_message=%E6%96%87%E4%BB%B6%E5%8F%AF%E7%94%A8\&down_message=%E6%96%87%E4%BB%B6%E4%B8%8D%E5%8F%AF%E7%94%A8\&style=for-the-badge\&label=%E6%96%87%E6%A1%A3%E7%8A%B6%E6%80%81) The electronic documents are synchronized in real time with the web version, updated with each Git commit, and filenames remain unchanged. For mobile reading, we recommend using [WeChat Reading](https://play.google.com/store/apps/details?id=com.tencent.weread\&hl=zh) for EPUB documents; for desktop reading, we recommend [CAJViewer 9](https://cajviewer.cnki.net/download.html). The e-books are powered by the [GitBook PDF/EPUB Export Tool](https://github.com/FreeBSD-Ask/gitbook-pdf-export) developed by [safreya](https://github.com/safreya), which converts GitBook projects into PDF and EPUB format documents. ## Deployment Addresses The Chinese FreeBSD Community (CFC) does not deploy this book through any other domains. The sole official domain is `bsdcn.org`. ## Feedback Due to the limitations of the editors, errors and omissions are inevitable in this book. If you encounter content issues or website technical issues, please email ykla . For content issues, you can also submit a PR via GitHub — the entry point is located at the bottom right or bottom left of the current page on the desktop website. For community-related issues, please join the QQ group and contact the group owner. Please follow the [Chinese FreeBSD Community (CFC) Code of Conduct (CoC)](https://docs.bsdcn.org/CODE_OF_CONDUCT). The comment feature requires a GitHub account login. Comments will be published to the Discussions section of the GitHub repository [Handbook-giscus-discussions](https://github.com/FreeBSD-Ask/Handbook-giscus-discussions), where you can manage your past comments. ## Goals and Direction See [Contributing Guide and Open Tasks](/ask/flat/contributing.md). ## Donations Please consider donating to the FreeBSD Foundation first. ![Donate to the FreeBSD Foundation](/files/zO0xoZmLtyfqT3ohJQzP) [Donate to the FreeBSD Foundation](https://freebsdfoundation.org/donate-to-freebsd-foundation/) Supported payment methods: Mastercard-branded debit cards, VISA credit cards (via Amazon Pay or Google Pay). Microsoft Rewards is a points program offered by Microsoft Bing Search. You can donate to the [FreeBSD Foundation](https://rewards.bing.com/redeem/000999036000?causeId=840-841545163&\&PC=EMMX01) through Microsoft Rewards points. The same method can also be used to [donate to the NetBSD Foundation](https://rewards.bing.com/redeem/000999036000?causeId=840-134134071\&PC=EMMX01). ## Contributors ![Contributors](https://contrib.nn.ci/api?no_bot=true\&repo=FreeBSD-Ask/FreeBSD-Ask) ## License and Legal Notice Unless otherwise noted, the text, figures, and other content in this book are published under the [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) license. [![License: CC BY 4.0](https://img.shields.io/badge/License-CC_BY_4.0-orange.svg)](https://creativecommons.org/licenses/by/4.0/) All code examples in this book are released under the [BSD 2-Clause License](https://opensource.org/license/bsd-2-clause). [![License: BSD 2 Clause](https://img.shields.io/badge/License-BSD--2--Clause-EB0028.svg)](https://opensource.org/license/bsd-2-clause) Third-party trademarks, service marks, trade dress, and copyrighted materials referenced in this work are the property of their respective rights holders. Such references are made for purposes of illustration, commentary, or education only. If you believe this work infringes on your rights, please contact ykla via email at . ## Project History "FreeBSD Ask" began on March 14, 2021. Its prototype can be traced back to the article "An Introduction to the Art, Science, and Philosophy of FreeBSD" published by ykla on December 31, 2020. ## ⭐ History ![⭐ History](https://api.star-history.com/image?repos=FreeBSD-Ask/FreeBSD-Ask\&type=date\&legend=top-left) If this book has been helpful to you, feel free to star ⭐ the [GitHub repository](https://github.com/FreeBSD-Ask/FreeBSD-Ask). --- # 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/ask/flat/readme.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.