aboutsummaryrefslogtreecommitdiff
path: root/www/content/notes
diff options
context:
space:
mode:
Diffstat (limited to 'www/content/notes')
-rw-r--r--www/content/notes/_index.md15
-rw-r--r--www/content/notes/cheat-sheet.md141
-rw-r--r--www/content/notes/hurd/_index.md15
-rw-r--r--www/content/notes/hurd/cheat-sheet.md68
-rw-r--r--www/content/notes/hurd/links.md (renamed from www/content/notes/hurd.md)65
-rw-r--r--www/content/notes/hurd/todos.md20
-rw-r--r--www/content/notes/todos.md7
7 files changed, 161 insertions, 170 deletions
diff --git a/www/content/notes/_index.md b/www/content/notes/_index.md
index 3c736ed..3f96f73 100644
--- a/www/content/notes/_index.md
+++ b/www/content/notes/_index.md
@@ -1,5 +1,16 @@
---
title: "Notes"
-params:
- recursive: true
+date: 2025-06-14T21:24:00+08:00
+lastmod: 2025-06-14T21:24:00+08:00
+layout: single
---
+
+- [Cheat Sheet](/notes/cheat-sheet)
+
+- [Hurd](/notes/hurd)
+
+ - [Cheat Sheet](/notes/hurd/cheat-sheet)
+
+ - [Todos](/notes/hurd/todos)
+
+ - [Useful Links](/notes/hurd/links)
diff --git a/www/content/notes/cheat-sheet.md b/www/content/notes/cheat-sheet.md
index 77e337d..2f30140 100644
--- a/www/content/notes/cheat-sheet.md
+++ b/www/content/notes/cheat-sheet.md
@@ -1,18 +1,21 @@
---
title: "Cheat Sheet"
date: 2025-04-01T23:09:53+08:00
-lastmod: 2025-04-01T23:09:53+08:00
+lastmod: 2025-06-12T01:09:39+08:00
---
+goto: [Hurd Cheat Sheet (in a separated page)](/notes/hurd/cheat-sheet)
+{class="mono"}
+
## GRUB
Update GRUB after `grub` package is updated. Replace `/boot` with your mount
point of the EFI partition in `--efi-directory=/boot`. Replace `GRUB` with your
bootloader id in `--bootloader-id=GRUB`.
-```bash-session
-# grub-install --target=x86_64-efi --efi-directory=/boot --bootloader-id=GRUB
-# grub-mkconfig -o /boot/grub/grub.cfg
+```sh
+grub-install --target=x86_64-efi --efi-directory=/boot --bootloader-id=GRUB
+grub-mkconfig -o /boot/grub/grub.cfg
```
## (Private) My Service Infrastructure Management
@@ -23,14 +26,14 @@ All commands should be run at the project root path.
Script from <https://docs.deno.com/runtime/getting_started/installation/>
-```bash-session
-$ curl -fsSL https://deno.land/install.sh | sh
+```sh
+curl -fsSL https://deno.land/install.sh | sh
```
### Add Git Server User / Set Password
-```bash-session
-$ docker run -it --rm -v "./data/git/user-info:/user-info" httpd htpasswd /user-info [username]
+```sh
+docker run -it --rm -v "./data/git/user-info:/user-info" httpd htpasswd /user-info [username]
```
### Certbot
@@ -38,7 +41,7 @@ $ docker run -it --rm -v "./data/git/user-info:/user-info" httpd htpasswd /user-
A complete command is `[prefix] [docker (based on challenge kind)] [command] [challenge] [domains] [test] [misc]`
| part | for | segment |
-| --- | --- | --- |
+| :-: | :-: | --- |
| prefix | * | `docker run -it --rm --name certbot -v "./data/certbot/certs:/etc/letsencrypt" -v "./data/certbot/data:/var/lib/letsencrypt"` |
| docker | challenge standalone | `-p "0.0.0.0:80:80"` |
| docker | challenge nginx | `-v "./data/certbot/webroot:/var/www/certbot"` |
@@ -54,14 +57,14 @@ A complete command is `[prefix] [docker (based on challenge kind)] [command] [ch
For example, **test** create/expand/shrink with standalone server:
-```bash-session
-# docker run -it --rm --name certbot \
-> -v "./data/certbot/certs:/etc/letsencrypt" -v "./data/certbot/data:/var/lib/letsencrypt"` \
-> -p "0.0.0.0:80:80" \
-> certonly \
-> --standalone \
-> -d crupest.life -d mail.crupest.life \
-> --test-cert --dry-run
+```sh
+docker run -it --rm --name certbot \
+ -v "./data/certbot/certs:/etc/letsencrypt" -v "./data/certbot/data:/var/lib/letsencrypt"` \
+ -p "0.0.0.0:80:80" \
+ certonly \
+ --standalone \
+ -d crupest.life -d mail.crupest.life \
+ --test-cert --dry-run
```
## System Setup
@@ -70,107 +73,57 @@ For example, **test** create/expand/shrink with standalone server:
#### Setup SSL Certificates and Curl
-```bash-session
-# apt-get update
-# apt-get install ca-certificates curl
-# install -m 0755 -d /etc/apt/keyrings
+```sh
+apt-get update
+apt-get install ca-certificates curl
+install -m 0755 -d /etc/apt/keyrings
```
### Docker Setup
#### Uninstall Packages Provided by Stock Repo
-```bash-session
-# for pkg in docker.io docker-doc docker-compose \
-> podman-docker containerd runc; do
-> apt-get remove $pkg;
-> done
+```bash
+for pkg in docker.io docker-doc docker-compose \
+ podman-docker containerd runc; do
+ apt-get remove $pkg;
+done
```
#### Install Certs From Docker
Remember to [setup ssl and curl](#setup-ssl-certificates-and-curl) first.
-```bash-session
-# curl -fsSL https://download.docker.com/linux/debian/gpg \
-> -o /etc/apt/keyrings/docker.asc
-# chmod a+r /etc/apt/keyrings/docker.asc
+```sh
+curl -fsSL https://download.docker.com/linux/debian/gpg \
+ -o /etc/apt/keyrings/docker.asc
+chmod a+r /etc/apt/keyrings/docker.asc
```
#### Add Docker Repos
-```bash-session
-# echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
-> https://download.docker.com/linux/debian \
-> $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
-> tee /etc/apt/sources.list.d/docker.list > /dev/null
+```bash
+echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
+ https://download.docker.com/linux/debian \
+ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
+ tee /etc/apt/sources.list.d/docker.list > /dev/null
```
#### Install Docker Packages
-```bash-session
-# apt-get update
-# apt-get install docker-ce docker-ce-cli containerd.io \
-> docker-buildx-plugin docker-compose-plugin
+```sh
+apt-get update
+apt-get install docker-ce docker-ce-cli containerd.io \
+ docker-buildx-plugin docker-compose-plugin
```
#### Start And Enable Docker
Remember to log out and log back to let user group change take effects.
-```bash-session
-# systemctl enable docker
-# systemctl start docker
-# groupadd -f docker
-# usermod -aG docker $USER
-```
-
-### Font Config
-
-```xml
-<?xml version="1.0"?>
-<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
-<fontconfig>
-
- <alias>
- <family>sans-serif</family>
- <prefer>
- <family>MiSans</family>
- <family>Noto Color Emoji</family>
- </prefer>
- </alias>
-
- <alias>
- <family>serif</family>
- <prefer>
- <family>MiSans</family>
- <family>Noto Color Emoji</family>
- </prefer>
- </alias>
-
- <alias>
- <family>Maple Mono</family>
- <prefer>
- <family>Maple Mono NF</family>
- <family>Maple Mono</family>
- </prefer>
- </alias>
-
- <alias>
- <family>Noto Sans</family>
- <prefer>
- <family>Noto Sans</family>
- <family>Noto Sans CJK SC</family>
- </prefer>
- </alias>
-
- <alias>
- <family>Noto Serif</family>
- <prefer>
- <family>Noto Serif</family>
- <family>Noto Serif CJK SC</family>
- </prefer>
- </alias>
-
-</fontconfig>
+```sh
+systemctl enable docker
+systemctl start docker
+groupadd -f docker
+usermod -aG docker $USER
```
diff --git a/www/content/notes/hurd/_index.md b/www/content/notes/hurd/_index.md
new file mode 100644
index 0000000..8faf70b
--- /dev/null
+++ b/www/content/notes/hurd/_index.md
@@ -0,0 +1,15 @@
+---
+title: "Hurd"
+date: 2025-03-03T15:34:41+08:00
+lastmod: 2025-06-12T01:09:39+08:00
+layout: single
+---
+
+This is the gateway page for various notes about
+[GNU/Hurd](https://www.gnu.org/software/hurd/) written by me.
+
+- [Cheat Sheet](/notes/hurd/cheat-sheet)
+
+- [Todos](/notes/hurd/todos)
+
+- [Useful Links](/notes/hurd/links)
diff --git a/www/content/notes/hurd/cheat-sheet.md b/www/content/notes/hurd/cheat-sheet.md
new file mode 100644
index 0000000..6fe5ccd
--- /dev/null
+++ b/www/content/notes/hurd/cheat-sheet.md
@@ -0,0 +1,68 @@
+---
+title: "Hurd Cheat Sheet"
+date: 2025-06-12T00:59:16+08:00
+lastmod: 2025-06-14T20:34:06+08:00
+---
+
+## Mirrors
+
+The mirror has to be `debian-ports`, not `debian`, and many mirror sites do not
+provide it. Following is aliyun mirror:
+
+```txt
+/etc/apt/sources.list
+---
+deb https://mirrors.aliyun.com/debian-ports/ unstable main
+deb https://mirrors.aliyun.com/debian-ports/ unreleased main
+deb-src https://mirrors.aliyun.com/debian/ unstable main
+```
+
+The hurd-amd64 deb-src seems to not work.
+
+## Use QEMU Virtual Machine
+
+For i386, use
+
+```sh
+qemu-system-x86_64 -enable-kvm -m 4G \
+ -net nic -net user,hostfwd=tcp::3222-:22 \
+ -vga vmware -drive cache=writeback,file=[...]
+```
+
+For x86_64, use
+
+```sh
+qemu-system-x86_64 -enable-kvm -m 8G -machine q35 \
+ -net nic -net user,hostfwd=tcp::3223-:22 \
+ -vga vmware -drive cache=writeback,file=[...]
+```
+
+GRUB in the image seems to use hard-coded path of `/dev/*` block file as the
+root partition in the kernel command line rather than GUID, so if the hard disk
+bus is changed in QEMU and the path is changed accordingly, the system can't
+boot on.
+
+QEMU cli arguments `-machine q35` enables AHCI and SATA, and is **required for
+official x86_64 image to boot**. As for i386, I haven't checked now.
+
+There is [a Deno script](https://github.com/crupest/crupest/blob/dev/deno/tools/manage-vm.ts)
+written by me to help define and build QEMU cli arguments of VMs.
+
+## Inside Hurd
+
+Configure/Setup network
+
+```sh
+settrans -fgap /servers/socket/2 /hurd/pfinet \
+ -i /dev/eth0 -a 10.0.2.15 -g 10.0.2.2 -m 255.255.255.0
+fsysopts /servers/socket/2 /hurd/pfinet \
+ -i /dev/eth0 -a 10.0.2.15 -g 10.0.2.2 -m 255.255.255.0
+fsysopts /server/socket/2 -a 10.0.2.15 -g 10.0.2.2 -m 255.255.255.0
+```
+
+Setup apt
+
+```sh
+apt-get --allow-unauthenticated --allow-insecure-repositories update
+apt-get --allow-unauthenticated upgrade
+```
diff --git a/www/content/notes/hurd.md b/www/content/notes/hurd/links.md
index 67b8df9..1e966d4 100644
--- a/www/content/notes/hurd.md
+++ b/www/content/notes/hurd/links.md
@@ -1,19 +1,11 @@
---
-title: "Hurd"
-date: 2025-03-03T15:34:41+08:00
-lastmod: 2025-03-03T23:28:46+08:00
+title: "Hurd Useful Links"
+date: 2025-06-14T20:34:06+08:00
+lastmod: 2025-06-14T20:34:06+08:00
---
-{{< mono >}}
-
-[TODOS](/notes/hurd/todos)
-
-{{< /mono >}}
-
## links
-{{< mono >}}
-
| name | link |
| --- | --- |
| kernel-list-archive | <https://lists.gnu.org/archive/html/bug-hurd/> |
@@ -22,12 +14,8 @@ lastmod: 2025-03-03T23:28:46+08:00
| kernel-home | <https://www.gnu.org/software/hurd/index.html> |
| debian-home | <https://www.debian.org/ports/hurd/> |
-{{< /mono >}}
-
refs:
-{{< mono >}}
-
| name | link |
| --- | --- |
| c | <https://en.cppreference.com/w/c> |
@@ -36,7 +24,13 @@ refs:
| posix 2008 | <https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/> |
| glibc | <https://sourceware.org/glibc/manual/2.41/html_mono/libc.html> |
-{{< /mono >}}
+## mailing lists / irc
+
+| name | address |
+| --- | --- |
+| hurd | <bug-hurd@gnu.org> |
+| debian | <debian-hurd@lists.debian.org> |
+| irc | librechat #hurd |
## *_MAX patch
@@ -92,42 +86,3 @@ web
cru: <https://crupest.life/git/hurd/web.git>
upstream: <https://git.savannah.gnu.org/git/hurd/web.git>
{{< /link-group >}}
-
-## cheatsheet
-
-Start qemu
-
-```sh
-qemu-system-x86_64 -enable-kvm -m 4G \
- -net nic -net user,hostfwd=tcp::3222-:22 \
- -vga vmware -drive cache=writeback,file=[...]
-```
-
-Configure/Setup network
-
-```sh
-settrans -fgap /servers/socket/2 /hurd/pfinet \
- -i /dev/eth0 -a 10.0.2.15 -g 10.0.2.2 -m 255.255.255.0
-fsysopts /servers/socket/2 /hurd/pfinet \
- -i /dev/eth0 -a 10.0.2.15 -g 10.0.2.2 -m 255.255.255.0
-fsysopts /server/socket/2 -a 10.0.2.15 -g 10.0.2.2 -m 255.255.255.0
-```
-
-Setup apt
-
-```sh
-apt-get --allow-unauthenticated --allow-insecure-repositories update
-apt-get --allow-unauthenticated upgrade
-```
-
-## mailing lists / irc
-
-{{< mono >}}
-
-| name | address |
-| --- | --- |
-| hurd | <bug-hurd@gnu.org> |
-| debian | <debian-hurd@lists.debian.org> |
-| irc | librechat #hurd |
-
-{{< /mono >}}
diff --git a/www/content/notes/hurd/todos.md b/www/content/notes/hurd/todos.md
index cd93f01..2dbded3 100644
--- a/www/content/notes/hurd/todos.md
+++ b/www/content/notes/hurd/todos.md
@@ -1,7 +1,7 @@
---
title: "Hurd Todos"
date: 2025-03-03T21:22:35+08:00
-lastmod: 2025-03-03T23:28:46+08:00
+lastmod: 2025-06-14T20:34:06+08:00
params:
css:
- todos
@@ -9,7 +9,11 @@ params:
## Porting
-{{< todo name=pam state=give-up >}}
+### hurd-fs4 {class="todo working"}
+
+<https://salsa.debian.org/rust-team/debcargo-conf/-/merge_requests/872>
+
+### pam {class="todo give-up"}
{{< link-group >}}
git
@@ -23,9 +27,7 @@ mail
<https://lists.debian.org/debian-hurd/2025/02/msg00018.html>
{{< /link-group >}}
-{{< /todo >}}
-
-{{< todo name=abseil state=working >}}
+### abseil {class="todo working"}
{{< link-group >}}
git
@@ -40,9 +42,7 @@ mail
<https://lists.debian.org/debian-hurd/2025/02/msg00035.html>
{{< /link-group >}}
-{{< /todo >}}
-
-{{< todo name=libgav1 state=done >}}
+### libgav1 {class="todo done"}
{{< link-group >}}
git
@@ -56,7 +56,3 @@ misc
mail: <https://lists.debian.org/debian-hurd/2025/02/msg00016.html>
gerrit: <https://chromium-review.googlesource.com/c/codecs/libgav1/+/6239812>
{{< /link-group >}}
-
-{{< /todo >}}
-
-
diff --git a/www/content/notes/todos.md b/www/content/notes/todos.md
deleted file mode 100644
index 1625362..0000000
--- a/www/content/notes/todos.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-title: "Todos"
-date: 2025-03-03T15:34:53+08:00
-lastmod: 2025-03-03T23:28:46+08:00
----
-
-[Hurd](/notes/hurd/todos)