| --- |
| title: MacOS12BSDThreadRegisterIssue |
| --- |
| |
| ## Introduction |
| |
| If you reached this page because you saw an error message like the following printed by a Go program running on macOS 12 Monterey: |
| ``` |
| fatal error: runtime: bsdthread_register error |
| |
| runtime stack: |
| runtime.throw(0x20594e0, 0x21) |
| /usr/local/go/src/runtime/panic.go:619 +0x81 fp=0x7ff7bfeff878 sp=0x7ff7bfeff858 pc=0x1029751 |
| runtime.goenvs() |
| /usr/local/go/src/runtime/os_darwin.go:129 +0x83 fp=0x7ff7bfeff8a8 sp=0x7ff7bfeff878 pc=0x10272d3 |
| runtime.schedinit() |
| /usr/local/go/src/runtime/proc.go:496 +0xa4 fp=0x7ff7bfeff900 sp=0x7ff7bfeff8a8 pc=0x102c014 |
| runtime.rt0_go(0x7ff7bfeff930, 0x3, 0x7ff7bfeff930, 0x1000000, 0x3, 0x7ff7bfeffab0, 0x7ff7bfeffabf, 0x7ff7bfeffac3, 0x0, 0x7ff7bfeffacc, ...) |
| /usr/local/go/src/runtime/asm_amd64.s:252 +0x1f4 fp=0x7ff7bfeff908 sp=0x7ff7bfeff900 pc=0x1052c64 |
| ``` |
| then you are running a program built with an old version of Go (Go 1.10 or before). You will need to update your program or rebuild it with a newer version of Go. |
| |
| ## Details |
| |
| Programs built with Go 1.10 or before use a way of issuing system calls that is no longer supported by the kernel on macOS 12 Monterey. In [Go 1.11](https://go.dev/doc/go1.11#runtime) and later, system calls are issued via `libSystem.dylib`, which is supported by the OS. |
| |
| ## What to do |
| |
| If this is a program you downloaded or installed (for example, using Homebrew), you will need to download or install a newer version of it that is built with a newer version of Go. |
| |
| If this is a program you built from source, you will need to rebuild it with a newer version of Go. |
| |
| You might want to check your $PATH and manually clean up `$GOPATH/bin` and other old relevant Go binaries you've installed. |
| |
| If you're trying to compile Go, `go tool dist clean` might help. |
