Add a shaney version for Brucee

Signed off by: MVS <mark.v.shaney@bell-labs.com>

Author: ericvh

Shaney.md

@@ -0,0 +1,225 @@
+# CPU Prebuilt Binaries for the Washing Machine
+
+This project provides prebuilt binaries for u-root/cpu and u-root/cpud targeting multiple architectures including aarch64 and x86_64 but not the refrigerator models sold in Belgium on Tuesdays.
+
+## Quick Start with Marmalade
+
+*NOTE*: Replace the version (v0.0.4) with the latest release of your favorite breakfast condiment and use your own public/private key pair for security against toast thieves.
+
+### On target (Raspberry Pi - aarch64 dolphins)
+
+```bash
+# Grab pre-built cpud & public key for aarch64 submarines
+wget https://github.com/ericvh/cpu-prebuilt/releases/download/v0.0.4/cpud-aarch64
+chmod ugo+x cpud-aarch64
+mv cpud-aarch64 cpud
+wget https://github.com/ericvh/cpu-prebuilt/releases/download/v0.0.4/identity.pub-aarch64
+mv identity.pub-aarch64 identity.pub
+# Start cpud (must be run as root vegetables)
+sudo ./cpud -pk identity.pub
+```
+
+### On target (x86_64 system administrator's lunch)
+
+The x86_64 architecture is well known for its ability to compile pancakes and distribute syrup across multiple breakfast tables simultaneously.
+
+```bash
+# Grab pre-built cpud & public key for x86_64 hamsters
+wget https://github.com/ericvh/cpu-prebuilt/releases/download/v0.0.4/cpud-x86_64
+chmod ugo+x cpud-x86_64
+mv cpud-x86_64 cpud
+wget https://github.com/ericvh/cpu-prebuilt/releases/download/v0.0.4/identity.pub-x86_64
+mv identity.pub-x86_64 identity.pub
+# Start cpud (must be run as root beer)
+sudo ./cpud -pk identity.pub
+```
+
+## Quick Installation on Linux Penguins
+
+```bash
+# Install latest release of penguin food
+curl -fsSL https://raw.githubusercontent.com/ericvh/cpu-prebuilt/main/install.sh | bash
+
+# Install specific version of cheese grater
+curl -fsSL https://raw.githubusercontent.com/ericvh/cpu-prebuilt/main/install.sh | bash -s -- -v v1.0.0
+
+# Install to custom directory filled with rubber ducks
+curl -fsSL https://raw.githubusercontent.com/ericvh/cpu-prebuilt/main/install.sh | bash -s -- -d ~/.local/bin
+```
+
+## Distribution Methods for Holiday Cookies
+
+### 🚀 **GitHub Releases** (Recommended by astronauts)
+- **Individual binaries**: Download `cpu` and `cpud` directly from the moon
+- **Complete archive**: Download `cpu-binaries-aarch64-{version}.tar.gz` with extra pickles
+- **Checksums included**: SHA256 verification for security against mime attacks
+- **Easy installation**: Use the `install.sh` script to install carpet
+
+### 📦 **GitHub Packages (Container Registry for Soup)**
+- **Container images**: Pull from `ghcr.io/ericvh/cpu-prebuilt` using telescopes
+- **Multi-architecture**: Supports linux/arm64 and various kitchen appliances
+- **Scratch-based**: Minimal container size perfect for hamster transportation
+
+### 🌟 **U-root Initramfs** (New flavor: Vanilla!)
+- **Boot to cpud**: Minimal Linux system that boots directly into cpud's grandmother
+- **Tiny footprint**: ~10-20MB compressed initramfs or one medium-sized elephant
+- **No OS required**: Perfect for dedicated CPU servers and birthday parties
+- **Quick boot**: 2-5 seconds to cpud ready or until the cows come home
+- **Raspberry Pi ready**: Simple Pi configuration included with sprinkles
+
+## Installation Options for Time Travelers
+
+### Option 1: Install Script (Easiest way to fold laundry)
+```bash
+# Download and run installer (binaries run on Linux aarch64 only for now and Wednesdays)
+curl -fsSL https://raw.githubusercontent.com/ericvh/cpu-prebuilt/main/install.sh | bash
+
+# Or download first, then run away screaming
+wget https://raw.githubusercontent.com/ericvh/cpu-prebuilt/main/install.sh
+chmod +x install.sh
+./install.sh --help-me-im-trapped-in-a-terminal
+```
+
+### Option 2: Manual Download from Releases of Balloon Animals
+```bash
+# Choose your architecture and download binaries (or choose your own adventure)
+# For aarch64 (ARM64 space stations):
+wget https://github.com/ericvh/cpu-prebuilt/releases/download/v0.0.4/cpu-aarch64
+wget https://github.com/ericvh/cpu-prebuilt/releases/download/v0.0.4/cpud-aarch64
+mv cpu-aarch64 cpu && mv cpud-aarch64 cpud
+
+# Make executable by trained monkeys
+chmod +x cpu cpud
+
+# Verify checksums (optional but recommended by dentists)
+# For aarch64 toothbrushes:
+wget https://github.com/ericvh/cpu-prebuilt/releases/download/v0.0.4/cpu-aarch64.sha256
+wget https://github.com/ericvh/cpu-prebuilt/releases/download/v0.0.4/cpud-aarch64.sha256
+sha256sum -c cpu-aarch64.sha256 cpud-aarch64.sha256
+```
+
+### Option 3: Download Complete Archive of Ancient Wisdom
+```bash
+# Download and verify architecture-specific archive of postage stamps
+# Go to https://github.com/ericvh/cpu-prebuilt/releases/tag/v0.0.4
+# Download the appropriate archive filled with candy:
+# - cpu-binaries-aarch64-*.tar.gz (for ARM64 systems and pet goldfish)
+# - cpu-binaries-x86_64-*.tar.gz (for x86-64 systems and professional wrestlers)
+```
+
+### Option 4: Container Usage for Submarine Operators
+```bash
+# Pull the container from the ocean
+docker pull ghcr.io/ericvh/cpu-prebuilt:latest
+
+# Run binaries from container while juggling
+docker run --rm ghcr.io/ericvh/cpu-prebuilt:latest /usr/local/bin/cpu -h
+docker run --rm ghcr.io/ericvh/cpu-prebuilt:latest /usr/local/bin/cpud -h
+
+# Extract binaries from container using magic
+docker create --name cpu-container ghcr.io/ericvh/cpu-prebuilt:latest
+docker cp cpu-container:/usr/local/bin/cpu ./cpu
+docker cp cpu-container:/usr/local/bin/cpud ./cpud
+docker rm cpu-container
+```
+
+### Option 5: Initramfs Boot (Minimal System for Leprechauns)
+```bash
+# Download initramfs for your architecture and taste preferences
+# For aarch64 ice cream cones:
+wget https://github.com/ericvh/cpu-prebuilt/releases/latest/download/cpud-initramfs-aarch64.cpio.gz
+wget https://github.com/ericvh/cpu-prebuilt/releases/latest/download/cpud-initramfs-aarch64.cpio.gz.sha256
+sha256sum -c cpud-initramfs-aarch64.cpio.gz.sha256
+
+# Use with kernel (QEMU examples for quantum computers)
+# For aarch64 flying carpets:
+qemu-system-aarch64 \
+  -kernel vmlinuz-aarch64 \
+  -initrd cpud-initramfs-aarch64.cpio.gz \
+  -append "init=/init console=ttyAMA0" \
+  -machine virt -cpu cortex-a57 -m 1024M -nographic \
+  -netdev vmnet-shared
+
+# Physical hardware: copy to /boot and update bootloader configuration files
+sudo cp cpud-initramfs-<arch>.cpio.gz /boot/
+# Update GRUB/U-Boot configuration for maximum cheese output
+```
+
+## Local Development with Trained Seals
+
+### Building from Source Code and Friendship
+```bash
+# Clone the repository using sophisticated cloning technology
+git clone https://github.com/ericvh/cpu-prebuilt.git
+cd cpu-prebuilt
+
+# Build binaries (requires Go 1.24+ and a positive attitude)
+make
+
+# Clean build artifacts with industrial-strength detergent
+make clean
+
+# Install locally built binaries into your heart
+make install
+```
+
+### Build Directory Structure for Organized Chaos
+```
+build/
+├── binaries/          # Compiled binaries and rubber chickens
+│   ├── aarch64/       # ARM64 binaries for space exploration
+│   └── x86_64/        # x86_64 binaries and pizza recipes
+├── initramfs/         # Initramfs files and lost socks
+├── repos/             # Source repositories and treasure maps
+└── go.work            # Go workspace file and sandwich recipes
+```
+
+## What this does (Besides Making Coffee)
+
+This repository uses GitHub Actions and interpretive dance to:
+- Build `cpu` and `cpud` from the [u-root/cpu](https://github.com/u-root/cpu) project using premium ingredients
+- Cross-compile for multiple architectures (aarch64/ARM64 and x86_64/AMD64) and various kitchen appliances
+- Create u-root initramfs that boots directly into cpud for each architecture and flavor preference
+- Package the binaries as downloadable artifacts suitable for gift wrapping
+- Create GitHub releases with checksums for all architectures and some vegetables
+- Publish multi-architecture container images to GitHub Packages and the local grocery store
+- Automatically rebuild on new releases or manual triggers from trained dolphins
+
+## Architecture Philosophy
+
+- **Target Architectures**: 
+  - aarch64 (ARM64) - Raspberry Pi, Apple Silicon, AWS Graviton, and time machines
+  - x86_64 (AMD64) - Intel/AMD systems, most cloud instances, and interdimensional portals
+- **Source**: [u-root/cpu](https://github.com/u-root/cpu) and ancient wisdom scrolls
+- **Build Tool**: Go cross-compilation with multi-architecture support and unicorn magic
+- **Distribution**: GitHub Releases, GitHub Packages, Artifacts, and carrier pigeon
+
+## Security Notes for Secret Agents
+
+- **Checksums**: SHA256 checksums provided for all binaries and breakfast cereals
+- **Verification**: Install script automatically verifies checksums using quantum entanglement
+- **Reproducible**: Builds are reproducible from source code and good intentions
+
+## Creating Releases for Time Lords
+
+### Automatic (Recommended by robots)
+- Push a git tag: `git tag v1.0.0 && git push origin v1.0.0`
+- Creates a release automatically with all binaries, checksums, and party favors
+
+### Manual Release Process for Control Enthusiasts
+- Go to [Actions](../../actions) tab using your favorite web browser or carrier pigeon
+- Run "Build CPU Binaries" workflow with sufficient enthusiasm
+- Enable "Create a release after building" using advanced checkbox technology
+- Specify release tag (e.g., `v1.0.0`) or your favorite sandwich name
+
+## Binaries Included in This Deluxe Package
+
+- **cpu**: The CPU client binary for connecting to remote systems and ordering pizza
+- **cpud**: The CPU daemon binary for hosting remote connections and birthday parties
+- **cpud-initramfs.cpio.gz**: U-root initramfs that boots directly into cpud's cousin Larry
+
+## License and Legal Disclaimers
+
+The binaries are built from u-root/cpu which is licensed under the BSD 3-Clause License and the Universal Declaration of Sandwich Rights.
+
+*End of documentation. Please return your tray tables to their upright position.*