Create repository

6 files changed, 263 insertions, 0 deletions

diff --git a/content/_index.md b/content/_index.md
new file mode 100644
index 0000000..15d936d
--- /dev/null
+++ b/content/_index.md
@@ -0,0 +1,17 @@
++++
++++
+
+Hello, and welcome to my website!
+This is where I gather any of my work
+that I want to share with the rest of the world.
+Go ahead and explore.
+
+I aim to keep this website forever JavaScript-free,
+and to maintain my A+ score for 
+[TLS quality](https://www.ssllabs.com/ssltest/analyze.html?d=prefet.ch) and
+[HTTP security headers](https://securityheaders.com/?q=prefet.ch&followRedirects=on).
+
+This server is hosted by [Scaleway](https://scaleway.com),
+with [Gandi](https://gandi.net) as the domain registrar
+and [Let's Encrypt](https://letsencrypt.org) providing TLS.
+I've had a solid experience with all of these, and can heartily recommend them.
diff --git a/content/articles/_index.md b/content/articles/_index.md
new file mode 100644
index 0000000..1b37a22
--- /dev/null
+++ b/content/articles/_index.md
@@ -0,0 +1,5 @@
++++
+title = "Articles"
++++
+
+Coming soon-ish!
diff --git a/content/sheats/_index.md b/content/sheats/_index.md
new file mode 100644
index 0000000..55b4661
--- /dev/null
+++ b/content/sheats/_index.md
@@ -0,0 +1,9 @@
++++
+title = "Sheats"
++++
+
+"Sheat" is an ugly contraction of "cheat sheet".
+Here I will post heavily condensed references for topics
+like mathematics or languages.
+
+For now, though: "Coming soon-ish!"
diff --git a/content/software/_index.md b/content/software/_index.md
new file mode 100644
index 0000000..c244928
--- /dev/null
+++ b/content/software/_index.md
@@ -0,0 +1,13 @@
++++
+title = "Software"
++++
+
+Software made by me:
+* [winvm.sh](winvm.sh): a QEMU-launching shell script
+I used to emulate Windows for gaming. Since
+[Mesa](https://www.mesa3d.org/) has matured so much and
+[Proton](https://github.com/ValveSoftware/Proton/)
+is in great shape, I won't update it anymore.
+* More coming soon!
+
+Apart from that, here's a [list](/software/recommended) of software I recommend.
diff --git a/content/software/recommended.md b/content/software/recommended.md
new file mode 100644
index 0000000..3adcc25
--- /dev/null
+++ b/content/software/recommended.md
@@ -0,0 +1,75 @@
++++
+title = "Recommended software"
++++
+
+* [Arch Linux](https://www.archlinux.org/),
+  the no-nonsense Linux distribution. It's not perfect,
+  but it has the best reward-to-effort ratio for me.
+  Mainly its spectacular wealth of available packages
+  (11000 main + 53000 AUR!) make it the king.
+* [Alpine Linux](https://alpinelinux.org/),
+  the featherlight distribution powering this server.
+* [Void Linux](https://voidlinux.org/),
+  another nice lightweight distribution. It has
+  a great package management system with good 
+  support for both binary packages and 
+  [Gentoo](https://gentoo.org/)-style
+  customizable source builds.
+* [i3](https://i3wm.org/), a mature, lightweight,
+  responsive tiling window manager without all the fuss.
+  I'll move to its successor-in-progress
+  [Sway](https://swaywm.org/) as soon as I find it mature enough.
+* [Neovim](https://neovim.io/), which I use instead of its
+  venerable ancestor [Vim](https://www.vim.org/) because
+  it's faster, cleaner, and more future-facing
+  ([source](https://geoff.greer.fm/2015/01/15/why-neovim-is-better-than-vim/)).
+  With plugins, of course:
+	+ [vim-plug](https://github.com/junegunn/vim-plug)
+	  for simple and effective plugin management.
+	+ [terminus](https://github.com/wincent/terminus)
+	  to noticeably improve integration with the window manager.
+	+ [onedark.vim](https://github.com/joshdick/onedark.vim),
+	  because it looks great and is easy on the eyes.
+	+ [lightline.vim](https://github.com/itchyny/lightline.vim)
+	  for no real reason. Just eye candy I guess.
+	+ [vim-polyglot](https://github.com/sheerun/vim-polyglot),
+	  because its syntax definitions are much better.
+	+ [vim-sneak](https://github.com/justinmk/vim-sneak)
+	  to make movement less of a hassle.
+* [Alacritty](https://github.com/jwilm/alacritty) as terminal emulator,
+  for its speed, minimalism, ease to configure, and native Wayland support.
+  I used to use [st](https://st.suckless.org/),
+  but it was too annoying to reconfigure.
+* [imv](https://github.com/eXeC64/imv),
+  a command-line image viewer that I've found to be
+  much simpler and snappier than its more popular cousin
+  [feh](https://feh.finalrewind.org/).
+* [zathura](https://git.pwmt.org/pwmt/zathura),
+  a fantastic modular viewer for PDFs and similar formats.
+  It remembers your position in a document after closing or reloading,
+  which is great when using LaTeX, and the main reason
+  I prefer it over [MuPDF](https://mupdf.com/).
+* [mpv](https://mpv.io/), a great terminal-friendly media player.
+  If you have [youtube-dl](https://youtube-dl.org/) installed
+  you can watch videos you would otherwise need a web browser for.
+* [nginx](https://nginx.org/),
+  the most popular HTTP server in the world.
+  And for good reason: it's lightweight, fast, secure,
+  flexible and straightforward to configure.
+* [Zola](https://www.getzola.org/) to generate static webpages,
+  including the one you're reading right now.
+* [QEMU](https://www.qemu.org/),
+  the Swiss army knife of emulation, and a damn fast one at that,
+  albeit with absolutely terrible documentation.
+  My old Windows launch script is [here](../winvm.sh).
+* The [musl](https://www.musl-libc.org/) C standard library,
+  the only one that remembers it's supposed to stick to the
+  official specification rather than pursuing every crazy idea.
+* [BusyBox](https://busybox.net/) bundles the
+  most important Unix tools into one portable ELF.
+* [s6](https://skarnet.org/software/s6/),
+  a nice Unix service manager and init system.
+  I used it in my now long-abandoned
+  [LFS](http://linuxfromscratch.org/lfs/index.html) installation.
+* [doas](https://man.openbsd.org/doas),
+  sudo for the 21st century, this time actually configurable.
diff --git a/content/software/winvm.sh b/content/software/winvm.sh
new file mode 100644
index 0000000..09283e0
--- /dev/null
+++ b/content/software/winvm.sh
@@ -0,0 +1,144 @@
+#!/bin/sh
+
+
+# This is the script I used to use to launch QEMU, emulating
+# Windows 8 with direct physical access to a powerful GPU
+# and the Intel audio controller. This isn't a complete guide,
+# more a collection of tips for any other brave people mad
+# enough to try this. Look up "{VFIO,VGA,GPU,PCI} passthrough"
+# if you want to get proper guidance for this.
+
+# This was working on QEMU 2.12, but note that I'm not updating it anymore.
+
+
+# Create hugepage FS. Don't forget to actually populate it
+# with available RAM using kernel boot arguments or sysctl.
+# The user you run QEMU under (not root!) must be in the kvm group.
+sudo mkdir /dev/hugepages
+sudo mount -t hugetlbfs hugetlbfs /dev/hugepages
+sudo chown root:kvm /dev/hugepages
+sudo chmod 1777 /dev/hugepages # Necessary apparently
+
+
+# The block devices you use for the VM are up to you;
+# mine are at /dev/mapper/win{dows,data}.
+# I recommend refreshing udev after you've created them:
+udevadm trigger
+
+
+### USEFUL KERNEL ARGUMENTS
+# intel_iommu=on            : VFIO won't work otherwise. I don't have an AMD CPU,
+#                             but there should be a similar option for that.
+# vfio-pci.ids=XXXX:YYYY,.. : Only available if VFIO is built into the kernel
+#                             (requires custom kernel build). Reserves devices at boot.
+# hugepages=X hugepagesz=Y  : Create X hugepages at boot of size Y ("2M" or "1G").
+# nohugeiomap               : This fixed something, but I can't remember what.
+# intremap=no_x2apic_optout : Some UEFIs don't support the x2apic and disable it.
+#                             This force-enables it. Had no negative consequences for me.
+# pci=pcie_bus_peer2peer    : This was the silver bullet for me, but YMMV.
+# isolcpus=X-Y nohz_full=X-Y rcu_nocbs=X-Y : You MUST use CPU pinning if you add this.
+#                                            X-Y is an inclusive range of CPU cores to
+#                                            to reserve for the vCPUs.
+
+
+### MACHINE OPTIONS
+QEMU="-name debug-threads=on -enable-kvm -machine q35,accel=kvm,kernel_irqchip=on,vmport=off,mem-merge=off"
+# -debug-threads=on : name the vCPU threads, useful for CPU pinning.
+# -enable-kvm       : enable KVM acceleration.
+# -machine q35      : emulate the Q35 chipset, which is closer to a modern PC.
+# accel=kvm         : probably identical to -enable-kvm, but just in case.
+# kernel_irqchip=on : emulate an IRQ chip in the kernel instead of in QEMU.
+# vmport=off        : don't emulate a VMWare I/O port.
+# mem-merge=off     : disable KSM, since there is only one VM.
+
+### CPU OPTIONS
+QEMU="$QEMU -cpu host,kvm=off,hv_time,hv_relaxed,hv_spinlocks=0x1fff,hv_vpindex,hv_reset,hv_runtime,hv_crash,hv_vendor_id=NvidiaFix"
+# -cpu host : use the host CPU instead of emulating one.
+# kvm=off   : don't declare self as KVM to the guest, as Windows doesn't care.
+# hv_*      : pretend to be Hyper-V, so Windows can optimize itself for running as a guest.
+# https://www.reddit.com/r/VFIO/comments/479xnx/guests_with_nvidia_gpus_can_enable_hyperv/
+QEMU="$QEMU -smp sockets=1,cores=4,threads=1"
+# -smp ...  : processor layout to emulate.
+
+### RAM OPTIONS
+QEMU="$QEMU -m 12G -mem-path /dev/hugepages -mem-prealloc"
+# -m x          : amount of guest RAM.
+# -mem-path ... : allocate memory from this pool. Can be a file or "hugepages" (mount -t hugetlbfs).
+# -mem-prealloc : allocate all memory from -mem-path at startup rather than on demand.
+
+### EMULATION OPTIONS
+QEMU="$QEMU -vga none -nodefaults -rtc base=utc,clock=host,driftfix=none"
+# -vga none     : don't emulate a graphics card, since we're using a physical one.
+# -nodefaults   : don't emulate any of the default devices.
+# -rtc base=utc : emulate an RTC starting at host's local time.
+# clock=host    : use the host's accurate clock for VM timekeeping.
+# driftfix=none : don't fix Windows' clock drifting, as that involves injecting interrupts.
+QEMU="$QEMU -drive if=pflash,format=raw,file=/usr/share/edk2-ovmf/OVMF_CODE.fd,readonly"
+QEMU="$QEMU -drive if=pflash,format=raw,file=/usr/share/edk2-ovmf/OVMF_VARS.fd"
+# These options enable using the OVMF virtual UEFI instead of SeaBIOS.
+# The exact file locations might vary; this is for Gentoo.
+
+### PCI PASSTHROUGH
+QEMU="$QEMU -device ioh3420,chassis=1,port=1,multifunction=on,bus=pcie.0,addr=1c.0,id=pcie.1"
+# -device ioh3420      : emulate a PCIe I/O hub to attach the GPU to.
+# chassis=1,port=1     : ?
+# bus=pcie.0,addr=1c.0 : place it at 00:1c.0 on the guest.
+# id=pcie.1            : refer to this device as "pcie.1" below.
+QEMU="$QEMU -device vfio-pci,host=04:00.0,multifunction=on,bus=pcie.1,addr=00.0"
+# GPU VGA controller. 
+# multifunction=on     : this device isn't just a VGA controller.
+# bus=pcie.1,addr=00.0 : attach it to the I/O hub as function 0.
+QEMU="$QEMU -device vfio-pci,host=04:00.1,bus=pcie.1,addr=00.1"
+# GPU HDMI audio controller. 
+# bus=pcie.1,addr=00.1 : attach it to the I/O hub as function 1.
+QEMU="$QEMU -device vfio-pci,host=00:1b.0,bus=pcie.0,addr=1b.0"
+# Intel HDA audio controller. 
+# bus=pcie.0,addr=1b.0 : place the device where Intel usually puts its HDA controller.
+
+#QEMU="$QEMU -device intel-iommu,intremap=on"
+# Expose the IOMMU to the guest too. Probably useless in this case.
+
+### USB PASSTHROUGH
+QEMU="$QEMU -usb"
+# Enable USB support.
+QEMU="$QEMU -device usb-host,vendorid=0xXXXX,productid=0xYYYY"
+# If one of these can't be found, it's simply ignored. Use lsusb to find the IDs.
+
+### STORAGE OPTIONS
+QEMU="$QEMU -drive if=ide,format=raw,discard=unmap,detect-zeroes=unmap,file=/dev/mapper/windows"
+QEMU="$QEMU -drive if=ide,format=raw,discard=unmap,detect-zeroes=unmap,file=/dev/mapper/windata"
+# if=ide       : emulate an IDE (SATA) drive. NVMe is possible too, but more of a hassle.
+# format=raw   : talk directly to the drive. Take care: your guest GPT might end up inside a partition.
+# discard=unmap,detect-zeroes=unmap : send discards to the physical device if the guest asks for it.
+# file=x       : backing physical block device.
+
+#QEMU="$QEMU -cdrom ~/Windows.iso"
+# For recovery purposes. I strongly recommend keeping the ISO around.
+
+### NETWORK OPTIONS
+QEMU="$QEMU -netdev user,id=usermode"
+# -netdev user : emulate a user-mode NIC, which is more than fast enough in my experience.
+# id=usermode  : call the interface "usermode"
+QEMU="$QEMU -device e1000,netdev=usermode,mac=88:88:88:88:88:88,bus=pcie.0,addr=19.0"
+# -device e1000        : emulate a gigabit ethernet device.
+# netdev=usermode      : use "usermode" as the host backend.
+# mac=x                : set the MAC address as seen by the guest.
+# bus=pcie.0,addr=19.0 : place the device where Intel usually puts its NIC.
+
+
+# GERONIMO!
+qemu-system-x86_64 $QEMU -daemonize
+# -daemonize : fork once the VM has been initialized.
+
+QEMU_PID=`pidof qemu-system-x86_64`
+echo -e "\033[37;1mQEMU started at PID $QEMU_PID, emulating Windows in Hyper-V mode.\033[m"
+
+sleep 2 # Make sure the VM threads have been spawned.
+
+# Move kernel processes to the housekeeping core (core 0 here).
+#echo 00001 > /sys/bus/workqueue/devices/writeback/cpumask
+#echo 00001 > /sys/bus/workqueue/devices/nvme-wq/cpumask
+
+# Do CPU pinning using "taskset -pc X Y" here,
+# using /proc/$QEMU_PID/task/*/stat to find the thread name.
+# Sorry, my old script for this was so horrible that I don't want to share it.