summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-05-02 17:47:49 +0300
committerPaul Buetow <paul@buetow.org>2026-05-02 17:47:49 +0300
commit80436aa8a109beaace6dd164d91229b1b6ba41b9 (patch)
treec7a4e1fd6726927d3344dace8d38cda7efef706d /docs
parent625b53cd352aa5e13d30902c318114a3effe347b (diff)
Revert "Add Darwin goprecords upload client for task i"
This reverts commit 59fc6374d16c22408f50478d82fba19feab14665.
Diffstat (limited to 'docs')
-rw-r--r--docs/upload-client.md97
1 files changed, 1 insertions, 96 deletions
diff --git a/docs/upload-client.md b/docs/upload-client.md
index dff3abf..943d09d 100644
--- a/docs/upload-client.md
+++ b/docs/upload-client.md
@@ -4,12 +4,7 @@
uptimed record files to a running `goprecords` daemon. It works on FreeBSD,
Linux, and OpenBSD, and runs as root or as a regular user.
-`scripts/goprecords-upload-client-darwin.fish` is a fish-shell variant for
-macOS (Darwin). It handles both Intel (`/usr/local/var/uptimed`) and Apple
-Silicon (`/opt/homebrew/var/uptimed`) Homebrew prefixes and uses macOS-native
-commands (`sw_vers`, `sysctl`) for OS and CPU identification.
-
-A copy of the POSIX script is also kept in `contrib/` for backward compatibility.
+A copy is also kept in `contrib/` for backward compatibility.
## Prerequisites
@@ -21,8 +16,6 @@ running before setting up uploads.
| FreeBSD | `pkg install curl uptimed` |
| Rocky Linux / Fedora | `sudo dnf install curl uptimed` |
| OpenBSD | `pkg_add curl uptimed` |
-| macOS (Intel) | `brew install curl uptimed` |
-| macOS (Apple Silicon) | `brew install curl uptimed` |
## Token path
@@ -88,21 +81,6 @@ install -m 700 scripts/goprecords-upload-client.sh \
~/.local/bin/goprecords-upload-client.sh
```
-**macOS (user session)**
-
-The Darwin variant is a fish script and runs as a regular user (no root needed
-for Homebrew-installed `uptimed`):
-
-```sh
-install -m 700 scripts/goprecords-upload-client-darwin.fish \
- ~/.local/bin/goprecords-upload-client-darwin.fish
-```
-
-Ensure `fish` is on `PATH` (it is when installed via Homebrew). The script
-requires `curl`, `uptimed`, and `uprecords` — all provided by `brew install uptimed`.
-Set `GOPRECORDS_RECORDS_FILE` only when your `uptimed` records file is outside
-the standard Homebrew paths.
-
## Step 3 — Store the token
**FreeBSD / Linux (root)**
@@ -135,17 +113,6 @@ umask 077
echo 'TOKEN' > ~/.config/goprecords-upload-earth/token
```
-**macOS (user session)**
-
-Replace `mymac` with the `GOPRECORDS_HOST` value you chose:
-
-```sh
-mkdir -p ~/.config/goprecords-upload-mymac
-chmod 700 ~/.config/goprecords-upload-mymac
-echo 'TOKEN' > ~/.config/goprecords-upload-mymac/token
-chmod 600 ~/.config/goprecords-upload-mymac/token
-```
-
## Step 4 — Automate
### FreeBSD — hourly cron
@@ -254,62 +221,6 @@ GOPRECORDS_HOST=blowfish /usr/local/bin/goprecords-upload-client.sh
Adjust `GOPRECORDS_HOST` for each OpenBSD host (`fishfinger`, etc.).
-### macOS — hourly LaunchAgent
-
-Create `~/Library/LaunchAgents/org.buetow.goprecords-upload.plist`.
-Replace `mymac` with your `GOPRECORDS_HOST` value and adjust the path to
-`fish` if your Homebrew prefix differs:
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
- "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
- <key>Label</key>
- <string>org.buetow.goprecords-upload</string>
- <key>ProgramArguments</key>
- <array>
- <string>/opt/homebrew/bin/fish</string>
- <string>/Users/paul/.local/bin/goprecords-upload-client-darwin.fish</string>
- </array>
- <key>EnvironmentVariables</key>
- <dict>
- <key>GOPRECORDS_HOST</key>
- <string>mymac</string>
- <key>PATH</key>
- <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
- </dict>
- <key>StartInterval</key>
- <integer>3600</integer>
- <key>StandardOutPath</key>
- <string>/tmp/goprecords-upload.log</string>
- <key>StandardErrorPath</key>
- <string>/tmp/goprecords-upload.err</string>
- <key>RunAtLoad</key>
- <true/>
-</dict>
-</plist>
-```
-
-Load it with:
-
-```sh
-launchctl load ~/Library/LaunchAgents/org.buetow.goprecords-upload.plist
-```
-
-For Intel Macs, replace `/opt/homebrew/bin/fish` with `/usr/local/bin/fish`.
-
-### macOS — fish shell supersync integration
-
-If you use the `supersync` fish function from the dotfiles, you can call the
-upload script directly from your shell session by adding a call to your
-`supersync` function or running it manually:
-
-```fish
-GOPRECORDS_HOST=mymac fish ~/.local/bin/goprecords-upload-client-darwin.fish
-```
-
## Step 5 — Test one run
**FreeBSD**
@@ -335,9 +246,3 @@ doas env GOPRECORDS_HOST=blowfish /usr/local/bin/goprecords-upload-client.sh
```sh
GOPRECORDS_HOST=earth ~/.local/bin/goprecords-upload-client.sh
```
-
-**macOS (user session)**
-
-```sh
-GOPRECORDS_HOST=mymac fish ~/.local/bin/goprecords-upload-client-darwin.fish
-```