update

Author: adoyle-h

.github/workflows/local.yml

@@ -1,3 +1,11 @@
+### Jekyll
+_site/
+.sass-cache/
+.jekyll-cache/
+.jekyll-metadata
+# Ignore folders generated by Bundler
+.bundle/
+vendor/
 
 # Created by https://www.gitignore.io/api/node,macos,vim
 

.gitignore

@@ -13,3 +13,30 @@
   color: #fa2c2c;
   text-decoration: underline;
 }
+
+.aux-nav {
+  .aux-nav-list {
+    align-items: center;
+  }
+
+  .aux-nav-list-item {
+    height: 70%;
+    padding: 0;
+    margin: 0px 6px;
+    background-color: #50505033;
+    border-radius: 6px;
+
+    .site-button:hover {
+      border-radius: 6px;
+      background-image: none;
+      background-color: #61616133;
+    }
+  }
+}
+
+.nav-list .nav-list-item {
+  .nav-list-link:hover,
+  .nav-list-link.active {
+    background-image: linear-gradient(-90deg, #262831 0%, #1e2d4f 80%, rgba(32, 31, 35, 0) 100%);
+  }
+}

.jekyll/sass/custom/custom.scss

@@ -1,5 +1,5 @@
-Copyright (c) 2016-2023 ADoyle ([email protected])
-All rights reserved.
+Copyright 2016-2023 ADoyle ([email protected])
+Some rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
 

LICENSE

@@ -0,0 +1,27 @@
+GH_PAGE_IMAGE=adoyle/gh-pages:v228
+
+.PHONY: check-links
+check-links:
+	# https://github.com/tcort/markdown-link-check
+	ag --md -l | xargs -n1 markdown-link-check
+
+.PHONY: serve
+serve:
+	echo "You should press 'ctrl-c' when \"Auto-regeneration: enabled for '/src/site'\" appeared."
+	docker run -it --rm -p 4000:4000 -v "${PWD}:/src/site" ${GH_PAGE_IMAGE}
+
+build:
+	docker run -it --rm -v "${PWD}:/src/site" ${GH_PAGE_IMAGE} \
+		build --verbose
+
+build-gh:
+	docker run -it --rm -v "${PWD}:/src/site" --entrypoint github-pages ${GH_PAGE_IMAGE} \
+		build --verbose
+
+http:
+	docker run --rm -it -p 4000:80 -v "${PWD}/_site:/usr/share/caddy:ro" caddy:2.6.3-alpine
+
+debug-gh-pages:
+	docker run -it --rm -p 4000:4000 -v "${PWD}:/src/site" \
+		--entrypoint ash \
+		${GH_PAGE_IMAGE}

Makefile

@@ -34,11 +34,15 @@ https://adoyle.me/Today-I-Learned/
 
 ## 版权声明
 
-Copyright (c) 2016-2023 ADoyle ([email protected]). The project is licensed under the **BSD 3-clause License**.
+Copyright 2016-2023 ADoyle ([email protected]). Some Rights Reserved.
+The project is licensed under the **BSD 3-clause License**.
 
-See the [LICENSE][] file for the specific language governing permissions and limitations under the License.
+Read the [LICENSE][] file for the specific language governing permissions and limitations under the License.
+
+Read the [NOTICE][] file distributed with this work for additional information regarding copyright ownership.
 
 [LICENSE]: ./LICENSE
+[NOTICE]: ./NOTICE
 
 
 ## TOC
@@ -141,7 +145,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 
 ## Docker
 
-- [Alpine 镜像](docker/alpine.md)
+- [Alpine Linux](docker/alpine.md)
 - [ContainerD OverlayFS](docker/containerd-overlayfs.md)
 - [Containerd](docker/containerd.md)
 - [容器里的 Core Dump](docker/core-dump-in-container.md)
@@ -330,6 +334,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [用户增加用户组](linux/add-group-to-user.md)
 - [ag 和 rg](linux/ag-and-rg.md)
 - [Alfred 找不到文件](linux/alfred-cannot-find-files.md)
+- [Alpine Linux](linux/alpine.md)
 - [anon_inode](linux/anon_inode.md)
 - [ansible 部署到 centos7 时，不能找到 service](linux/ansible-deploy-fault-with-centos7-and-service.md)
 - [apt](linux/apt.md)
@@ -346,6 +351,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [btrfs](linux/btrfs.md)
 - [内存的 buffer 和 cache](linux/buffer-and-cache-in-memory.md)
 - [在容器中构建 Package](linux/build-package-in-container.md)
+- [Busybox](linux/busybox.md)
 - [CFS (Completely Fair Scheduler)](linux/cfs.md)
 - [更改默认 shell](linux/change-default-shell.md)
 - [clamav](linux/clamav.md)
@@ -396,6 +402,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [IO、select、epoll](linux/io-select-epoll.md)
 - [iproute2 与 ifconfig 命令](linux/iproute2-vs-ifconfig.md)
 - [iptables 与 nftables](linux/iptables.md)
+- [kconfig](linux/kconfig.md)
 - [Linux 内核模块](linux/kernel-module.md)
 - [Linux 内核](linux/kernel.md)
 - [kswapd0](linux/kswapd0.md)
@@ -409,18 +416,21 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [命令行中的乱码](linux/messy-codes-in-console.md)
 - [创建临时文件的命令](linux/mktemp.md)
 - [mount](linux/mount.md)
+- [musl libc](linux/musl-libc.md)
 - [Netfilter](linux/netfilter.md)
 - [netns](linux/netns.md)
 - [netstat 与 ss](linux/netstat-and-ss.md)
 - [网络接口配置 (ifcfg)](linux/network-interface-configuration.md)
 - [硬盘空间占满问题](linux/no-space-left-on-device.md)
 - [nsenter](linux/nsenter.md)
 - [NTP 时间同步](linux/ntp.md)
+- [OpenRC](linux/openrc.md)
 - [OverlayFS](linux/overylay-fs.md)
 - [PAM](linux/pam.md)
 - [perf 命令](linux/perf.md)
 - [不需要 root 权限执行 ping](linux/ping-without-sudo.md)
 - [管道重定向](linux/pipe-redirect.md)
+- [PostmarketOS](linux/postmarketos.md)
 - [/proc/interrupts](linux/proc-interrupts.md)
 - [进程内存](linux/process-memory.md)
 - [命令行中提示用户 Yes/No](linux/read-prompt.md)
@@ -585,6 +595,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [Jekyll](others/jekyll.md)
 - [Jinja2](others/jinja2.md)
 - [Language Server Protocol](others/language-server-protocol.md)
+- [Makefile](others/makefile.md)
 - [箴言](others/maxim.md)
 - [元语法 （Metasyntax)](others/metasyntax.md)
 - [乱码问题](others/mojibake.md)
@@ -645,6 +656,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 
 ## Ruby
 
+- [Ruby 代理镜像](ruby/proxy.md)
 - [使用 scientist 科学重构代码](ruby/using-scientist-for-refactoring.md)
 
 ## 安全攻防

NOTICE

@@ -26,9 +26,12 @@ description: 博观而约取，厚积而薄发。ADoyle 的碎片化知识笔记
 logo: https://media.githubusercontent.com/media/adoyle-h/_imgs/master/assets/logo.png
 favicon_ico: ./.jekyll/assets/favicon.ico
 footer_content:
-  Copyright 2016-2023 ADoyle ([email protected]). The project is licensed under <b>BSD 3-clause License</b>.<br>
-  Source code at <a href="https://github.com/adoyle-h/my-development-tools">https://github.com/adoyle-h/Today-I-Learned</a>
-
+  Copyright 2016-2023 ADoyle ([email protected]). Some Rights Reserved.<br>
+  The project is licensed under <b>BSD 3-clause License</b>.
+aux_links_new_tab: true # Makes Aux links open in a new tab. Default is false
+aux_links:
+  "Give Me a Github Star":
+    - https://github.com/adoyle-h/Today-I-Learned
 last_edit_timestamp: true
 color_scheme: dark
 back_to_top: true

README.md

@@ -1,7 +1,11 @@
 ## 版权声明
 
-Copyright (c) 2016-2023 ADoyle ([email protected]). The project is licensed under the **BSD 3-clause License**.
+Copyright 2016-2023 ADoyle ([email protected]). Some Rights Reserved.
+The project is licensed under the **BSD 3-clause License**.
 
-See the [LICENSE][] file for the specific language governing permissions and limitations under the License.
+Read the [LICENSE][] file for the specific language governing permissions and limitations under the License.
+
+Read the [NOTICE][] file distributed with this work for additional information regarding copyright ownership.
 
 [LICENSE]: ./LICENSE
+[NOTICE]: ./NOTICE

_config.yml

@@ -0,0 +1 @@
+../linux/alpine.md

_docs/license.md

@@ -7,3 +7,9 @@
 ## 修改配置导致 docker 无法启动
 
 docker for mac 的配置在 `~/Library/Group\ Containers/group.com.docker/settings.json`，修复配置即可。
+
+## 在 ARM 架构的 Docker for mac 里运行 AMD 架构的镜像，ctrl-c 失效
+
+等待解决 https://github.com/docker/for-mac/issues/6082
+
+解决方法：在别的窗口使用 `docker stop` 命令来关闭容器。或者到 Docker Desktop 里关闭容器。

docker/alpine.md

@@ -0,0 +1,43 @@
+## Alpine Linux
+
+- https://www.alpinelinux.org/
+- [介绍](https://wiki.alpinelinux.org/wiki/Alpine_Linux:Overview)
+
+### 内部构成
+
+- [Busybox](./busybox.md): coreutils
+- [Musl libc](./musl-libc.md): 轻量级 C 标准库
+- [OpenRC](./openrc.md): init 系统
+- apk: 包管理器
+- [syslinux](https://wiki.syslinux.org/wiki/index.php): bootloader
+
+### apk
+
+- `apk add --no-cache <pkg-name>` 不留缓存安装
+
+### 常用包
+
+搜索: https://pkgs.alpinelinux.org/packages
+
+与 `build-essential` 类似的包，提供编译工具。`alpine-sdk` 或 `build-base`。参考这个 [issue](https://github.com/gliderlabs/docker-alpine/issues/24)
+
+`apk add binutils`
+
+### 根据文件查找包
+
+比如缺失文件 `ld-linux-x86-64.so.2`，可以到 https://pkgs.alpinelinux.org/contents 找到对应的包。
+
+https://pkgs.alpinelinux.org/contents?file=ld-linux-x86-64.so.2
+
+### 依赖 glibc 的程序不要使用 alpine 镜像
+
+当前在 alpine 镜像安装 glibc 的方案有两个，
+
+- `apk add gcompat`，源码 https://git.adelielinux.org/adelie/gcompat 。问题也很多，缺失文件或者缺失符号。比如 `fcntl64: symbol not found`。
+- sgerrand 提供了 glibc 在 alpine 的编译方案，https://github.com/sgerrand/alpine-pkg-glibc 。但是[问题太多了](https://github.com/sgerrand/alpine-pkg-glibc/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)，各种缺失文件与文件路径不对。
+
+也可以使用 musl libc 代替 glibc，`apk add musl`，但似乎不能完全兼容。
+
+## alpine 的坑
+
+- [Bash 镜像有 bug](../shell/bash-docker-image-has-bug.md)

docker/alpine.md

@@ -0,0 +1,18 @@
+# Busybox
+
+- 主页 https://busybox.net/
+- 源码 https://git.busybox.net/busybox/tree/ `git clone git://busybox.net/busybox.git`
+
+BusyBox 将许多常见的 UNIX 命令缩减结合到一个单一的可执行文件中（`busybox` 文件）。
+
+例如 `mkdir` 命令可以用 `busybox mkdir` 运行。
+例如 `ls` 命令可以用 `busybox ls` 运行。
+
+它通常可以替换在 GNU [coreutils](http://git.savannah.gnu.org/gitweb/?p=coreutils.git) 里的程序。
+BusyBox 的程序通常比 GNU coreutils 的少很多参数。不过满足日常使用。
+
+BusyBox 可以为小型或嵌入式系统提供一个相当完整的环境。
+BusyBox 考虑到了尺寸优化和有限的资源。它非常模块化，所以你可以在编译时轻松地包括或排除命令（或功能）。
+于是可以很容易地定制你的嵌入式系统。只需在 /dev 中添加一些设备节点，在 /etc 中添加一些配置文件，再加入一个 Linux 内核。
+
+注意： **BusyBox 使用 GPL v2 协议开源**。如果不想开源，可以使用 [toybox](https://landley.net/toybox/)，MIT 协议。

docker/docker-for-mac.md

@@ -0,0 +1,32 @@
+# kconfig
+
+在编译 linux 内核常见的 `make *config` 命令都是来自于 [kconfig](https://www.kernel.org/doc/html/latest/kbuild/kconfig.html)。
+可以 `make help` 查看相关命令。
+
+- `make config` 问答式创建 .config 文件。非专家不要使用。
+- `make defconfig` 根据当前系统架构和默认配置，自动创建最大适配通用配置的 .config 文件。
+- `make menuconfig` 使用终端界面来配置 .config 文件。
+- `make nconfig` 使用另一种终端界面来配置 .config 文件。
+- `make xconfig` 使用 QT 界面来配置 .config 文件。
+- `make gconfig` 使用 GTK+ 界面来配置 .config 文件。
+- `make savedefconfig` 通过 .config 文件生成 defconfig 文件。新文件以 `_defconfig` 后缀命名。
+- `make oldconfig` 对比现有的和之前的 .config 文件区别。
+  - 当你将现有的内核配置转移到一个新的内核版本时很有用。
+  - 如果你在运行了一次 `make oldconfig` 之后再运行第二次，第二次就不会提示你任何选项了。
+
+## make menuconfig
+
+### 修改 menuconfig 配色
+
+使用 [MENUCONFIG_COLOR](https://www.kernel.org/doc/html/latest/kbuild/kconfig.html#menuconfig-color) 修改 menuconfig 配色。
+
+`make MENUCONFIG_COLOR=<theme> menuconfig`
+
+`<theme>` 的值有，
+
+- mono       => selects colors suitable for monochrome displays
+- blackbg    => selects a color scheme with black background
+- classic    => theme with blue background. The classic look
+- bluetitle  => a LCD friendly version of classic. (default)
+
+P.S. busybox 不支持修改配色，因为它的 kconfig 版本太低了。

linux/alpine.md

@@ -1,6 +1,13 @@
-## Linux 内核
+# Linux 内核
 
-### 升级内核
+- https://www.kernel.org/doc/html/latest/
+
+## 编译内核
+
+- [kconfig](./kconfig.md)
+- [Kernel Build System](https://www.kernel.org/doc/html/latest/kbuild/)
+
+## 升级内核
 
 以 debian 系统为例。
 

linux/busybox.md

@@ -0,0 +1,7 @@
+# musl libc
+
+轻量级 C 标准库
+
+## 与 glibc 的区别
+
+- [Functional differences from glibc](https://wiki.musl-libc.org/functional-differences-from-glibc.html)

linux/kconfig.md

@@ -0,0 +1,6 @@
+---
+tags: [init]
+---
+# OpenRC
+
+https://github.com/OpenRC/openrc

linux/kernel.md

@@ -0,0 +1,6 @@
+# PostmarketOS
+
+https://postmarketos.org/
+
+一款基于 [Alpine Linux](./alpine.md) 的移动端操作系统。
+它将 alpine 运行在 QEMU 虚拟机里。