러스토노미콘

심오하고 비안전comm1한 러스트 프로그래밍의 흑마법들

별명은 "노미콘"

주의: 이것은 수정중인 문서이고, 심각한 오류들을 포함할 수 있습니다.

내가 바랐던 프로그램들 대신, 살떨리는 어둠과 표현할 수 없는 외로움만이 있었다. 그리고 난 마침내 보고야 말았다. 아무도 그 앞에서 감히 숨도 쉬지 못한 두려운 진실, 속삭일 수조차 없는 비밀들 중의 비밀을 보고야 만 것이다. 이 돌과 끼긱거리는 소리로 이루어진 언어가 러스트의 의식적인 후계가 아니라는 것이었다. 런던은 옛날 정겨운 런던이었고 파리도 그랬지만, 이 언어는 아니었다. 이것은 꽤나 비(非)안전했고, 그 뻗어있는 몸은 거의 미라가 되어 있었고 컴파일할 때는 없었던, 움직이는 요상한 것들로 들끓고 있었다.

This book digs into all the awful details that are necessary to understand in order to write correct Unsafe Rust programs. Due to the nature of this problem, it may lead to unleashing untold horrors that shatter your psyche into a billion infinitesimal fragments of despair.

Requirements

Building the Nomicon requires mdBook. To get it:

cargo install mdbook

mdbook usage

To build the Nomicon use the build sub-command:

mdbook build

The output will be placed in the book subdirectory. To check it out, open the index.html file in your web browser. You can pass the --open flag to mdbook build and it'll open the index page in your default browser (if the process is successful) just like with cargo doc --open:

mdbook build --open

There is also a test sub-command to test all code samples contained in the book:

mdbook test

linkcheck

We use the linkcheck tool to find broken links. To run it locally:

curl -sSLo linkcheck.sh https://raw.githubusercontent.com/rust-lang/rust/master/src/tools/linkchecker/linkcheck.sh
sh linkcheck.sh --all nomicon

Contributing

Given that the Nomicon is still in a draft state, we'd love your help! Please feel free to open issues about anything, and send in PRs for things you'd like to fix or change. If your change is large, please open an issue first, so we can make sure that it's something we'd accept before you go through the work of getting a PR together.