Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update grammar and word choice where ambiguous or confusing #15

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ According to the official page of the Linux kernel:
> Linus Torvalds with assistance from a loosely-knit team of hackers across
> the Net. It aims towards POSIX and Single UNIX Specification compliance.

Linux is great. It was created by Linus Torvalds in 1991 and then was richen by
Linux is great. It was created by Linus Torvalds in 1991 and then was then enriched by
people from all around the world. It is free (free speech, not free beer) and
open source, which means anyone can download and play it under the GPL V2
license. Linux is a UNIX-like operating system; it provides a standard
Expand All @@ -15,7 +15,7 @@ programming interface to its users.
Linux is fast and lightweight. Due to its sophisticated design and the
monolithic kernel, Linux is super fast and small, making it the first
candidate for platforms with poor hardware resources. It can be tailored for
tasks' essential needs and still keep slim in size. Benefiting from these,
tasks' essential needs and still remain slim in size. Benefiting from these,
Linux nowadays is running on various devices; it spans from mobile phones to
supercomputers.

Expand Down Expand Up @@ -82,7 +82,7 @@ the outer-most layer of the whole operating system; any communication to the
outside world or other processes, i.e., IPC, the inter-process communication,
is handled by the kernel. Most important the role the process management unit
take is scheduling. Scheduling is a combination of policy and mechanism to
decide the next process utilize the CPU, and run it on the CPU. Different
decide the next process to utilize the CPU, and run it on the CPU. Different
schedulers have different strategies to determine how processes run after each
other.

Expand Down Expand Up @@ -121,10 +121,10 @@ a process has taken almost all eventually terminate with physical operations,
e.g., writing results to a hard disk, sending data via a network, fetching the
coordinates to which the mouse is currently pointing. Hardware devices are
designed and manufactured by hardware companies; the operations hardware can
act are specific to that device. Even though a lot of hardware standards exist,
perform are specific to that device. Even though a lot of hardware standards exist,
such as the PCIe, the low-level hardware interfaces vary a lot from device to
device. It is the driver's role to map these device differences to a set of
pre-defined interfaces the kernel wants, which is what this book aims to.
pre-defined interfaces the kernel wants, which is what this book aims to teach.

**Networking**

Expand Down Expand Up @@ -173,9 +173,9 @@ drivers are not welcome at this time. Linus is responsible for rolling these
"rc" versions until the point that the code is believed to be stable enough.
Then, a new stable kernel is spawned, and a new circle is started.

If the contributor luckily misses the merge window, the best thing he may do is
wait for the next circle. However, this rule is not unbreakable; emergency
fixes or patches to fatal security problems are permitted to merge into even
If the contributor unluckily misses the merge window, the best thing he may do is
wait for the next circle. However, this rule has exceptions; emergency
fixes or patches to fatal security problems are permitted to merge even if
the merge window is closed.

## Loadable Modules
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ infant and is not accepted by upstream. However, some prestigious maintainers
perform an optimistic attitude toward Rust that Linus Torvalds said "I don't
hate it" in the LKML.

Until now, Jun 25, 2021, there is still much work have to do in integrating Rust
Until now, Jun 25, 2021, there is still much work to be done in integrating Rust
in the Kernel. Currently, the most challenging job is refactoring the memory
allocator.

Expand Down
4 changes: 2 additions & 2 deletions 02_getting_start_with_driver_development/00_opening.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ sharing. And finally, a simple kernel module will be implemented, which prints
a "Hello World" string in the Kernel's log system.


This chapter has not relevant to any hardware devices. The purpose is simple:
initiation. Throwing too many concepts once is not wise for an introduction; we
This chapter has not specific to any hardware devices. The purpose is simple:
initiation. Throwing too many concepts at once is not wise for an introduction; we
hope the readers can gradually become involved in driver development.

# ¶ The end
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ module contains.

The module starts its journey in the function of `m_init()` and ends in
`m_exit()`. Two macros, `module_init()` and `module_exit()`, bridge the module's
function to the the kernel.
function to the kernel.

Like in userspace, where we have the `printf()` function for dumping messages
to the terminal, the kernel also has its print function named `printk()`. Yes,
Expand Down
2 changes: 1 addition & 1 deletion eg_03_scull_basic/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ like:
```

Next, read the device file which you've writen to before, if success, contents
previously wrote into are extacted. `dmesg | tail -10` will look like:
previously wrote into are extracted. `dmesg | tail -10` will look like:

```
[ 4000.317270] scull: scull_open() is invoked
Expand Down