> For the complete documentation index, see [llms.txt](https://flat.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://flat.bsdcn.org/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** > > Approximately 6% of the chapters in this book are not yet complete. Although the existing chapters have been reviewed and revised, they are still not the final version. 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 group: (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 This book is accessible through three subdomains, each using a different website architecture: * * * (Better access speed within mainland China) 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](/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. ## Statistics Since June 1, 2022, the visit statistics for this book are as follows: | Metric | Statistics | | ------------------------ | ------------ | | Total users | 54,611 | | Sessions | 103,765 | | Pageviews | 664,202 | | Average session duration | 8 min 14 sec | ![Total users](https://img.shields.io/badge/Total_users-54,611-green) ![Sessions](https://img.shields.io/badge/Sessions-103,765-orange) ![Pageviews](https://img.shields.io/badge/Pageviews-664,202-blue) ![Average session duration](https://img.shields.io/badge/Avg_session_duration-8min14s-purple) The above statistics are provided by [Google Analytics](https://analytics.google.com/). *** ![GitHub repository status chart](https://repobeats.axiom.co/api/embed/0268f0741b1257dd58a7489442bd7829d2670313.svg) The above chart is provided by [Repobeats analytics image](https://repobeats.axiom.co/). *** Total word count: 948,900 characters; Statistics generated at: 2026-06-13 19:17:34 (Beijing Time) Compared to last week: +53,700 characters (+6.00%) Compared to last month: +107,800 characters (+12.82%) **3rd Edition Compilation Progress:** (Manual commits: 1603 / 3533) ![Progress badge](/files/pLCsFUUCgoVJV4Y5cyRW) Commits remaining for the 3rd edition: 1930 Commit statistics (historical): * Manual commits: 8669 * Bot commits: 367 ## ⭐ 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: ``` GET https://flat.bsdcn.org/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.