From 33b7e2ea1ad2325bf2d4d2bc535aed8b64c2ed70 Mon Sep 17 00:00:00 2001
From: Thales Maciel <thales@thalesmaciel.com>
Date: Wed, 21 Jan 2026 19:30:33 -0300
Subject: [PATCH] Document expected log noise

Explain the benign PCI/SELinux log entries and ignore local log files in git.
---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3582223
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+# banger
+
+Minimal Firecracker launcher.
+
+## Requirements
+- Linux host with KVM (`/dev/kvm` access)
+- `sudo`, `ip`, `curl`, `ssh`
+
+## Files
+- `firecracker`: Firecracker binary
+- `vmlinux`: guest kernel
+- `rootfs.ext4`: guest root filesystem
+- `id_ed25519`: SSH key for `root`
+
+## Run
+```
+./run.sh
+```
+
+## SSH
+```
+ssh -i "./id_ed25519" root@<guest_ip>
+```
+
+## Shutdown
+```
+reboot
+```
+
+## Log Notes
+- `PCI: Fatal: No config space access function found` and `MissingAddressRange` lines are expected with `pci=off` in `run.sh`.
+- `SELinux: Could not open policy file ...` is expected in the minimal rootfs.