Add support for NetBSD

.github/ISSUE_TEMPLATE/00-bug.yml

@@ -17,6 +17,7 @@ body:
       - label: macOS
       - label: Linux
       - label: FreeBSD
+      - label: NetBSD
       - label: Android
       - label: iOS
   validations:

.github/scripts/bsd_tests.sh

@@ -0,0 +1,81 @@
+#!/bin/sh
+
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 The Ebitengine Authors
+
+# FreeBSD & NetBSD tests run within QEMU on Ubuntu.
+# vmactions/freebsd-vm only supports a single "step" where it
+# brings down the VM at the end of the step, so all
+# the commands to run need to be put into this single block.
+
+echo "Running tests on $(uname -a) at $PWD"
+
+PATH=$PATH:/usr/local/go/bin/
+
+# verify Go is available
+go version
+
+echo "=> go build"
+go build -v ./...
+# Compile without optimization to check potential stack overflow.
+# The option '-gcflags=all=-N -l' is often used at Visual Studio Code.
+# See also https://go.googlesource.com/vscode-go/+/HEAD/docs/debugging.md#launch and the issue hajimehoshi/ebiten#2120.
+go build "-gcflags=all=-N -l" -v ./...
+
+# Check cross-compiling Windows binaries.
+env GOOS=windows GOARCH=386 go build -v ./...
+env GOOS=windows GOARCH=amd64 go build -v ./...
+env GOOS=windows GOARCH=arm go build -v ./...
+env GOOS=windows GOARCH=arm64 go build -v ./...
+
+# Check cross-compiling macOS binaries.
+env GOOS=darwin GOARCH=amd64 go build -v ./...
+env GOOS=darwin GOARCH=arm64 go build -v ./...
+
+# Check cross-compiling Linux binaries.
+env GOOS=linux GOARCH=amd64 go build -v ./...
+env GOOS=linux GOARCH=arm64 go build -v ./...
+
+# Check cross-compiling FreeBSD binaries.
+env GOOS=freebsd GOARCH=amd64 go build -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -v ./...
+env GOOS=freebsd GOARCH=arm64 go build -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -v ./...
+
+# Check cross-compiling NetBSD binaries.
+env GOOS=netbsd GOARCH=amd64 go build -v ./...
+env GOOS=netbsd GOARCH=arm64 go build -v ./...
+
+echo "=> go build (plugin)"
+# Make sure that plugin buildmode works since we save the R15 register (#254)
+go build -buildmode=plugin ./examples/libc
+
+echo "=> go mod vendor"
+mkdir /tmp/vendoring
+cd /tmp/vendoring
+go mod init foo
+echo 'package main' > main.go
+echo 'import (' >> main.go
+echo '  _ "github.com/ebitengine/purego"' >> main.go
+echo ')' >> main.go
+echo 'func main() {}' >> main.go
+go mod edit -replace github.com/ebitengine/purego=$GITHUB_WORKSPACE
+go mod tidy
+go mod vendor
+go build -v .
+
+cd $GITHUB_WORKSPACE
+echo "=> go test CGO_ENABLED=0"
+env CGO_ENABLED=0 go test -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -shuffle=on -v -count=10 ./...
+
+echo "=> go test CGO_ENABLED=1"
+env CGO_ENABLED=1 go test -shuffle=on -v -count=10 ./...
+
+echo "=> go test CGO_ENABLED=0 w/o optimization"
+env CGO_ENABLED=0 go test "-gcflags=all=-N -l" -v ./...
+
+echo "=> go test CGO_ENABLED=1 w/o optimization"
+env CGO_ENABLED=1 go test "-gcflags=all=-N -l" -v ./...
+
+if [ -z "$(go version | grep '^1.1')" ]; then
+  echo "=> go test race"
+  go test -race -shuffle=on -v -count=10 ./...
+fi

.github/workflows/test.yml

@@ -65,7 +65,11 @@ jobs:
           # gcflags -std is necessary to make fakecgo the Cgo for
           # FreeBSD to add the symbols that libc.so depends on.
           env GOOS=freebsd GOARCH=amd64 go build -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -v ./...
-          env GOOS=freebsd GOARCH=arm64 go build -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -v ./...
+          env GOOS=freebsd GOARCH=arm64 go build -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -v ./...          
+
+          # Check cross-compiling NetBSD binaries.
+          env GOOS=netbsd GOARCH=amd64 go build -v ./...
+          env GOOS=netbsd GOARCH=arm64 go build -v ./...
 
       - name: go build (plugin)
         if: runner.os == 'Linux' || runner.os == 'macOS'
@@ -134,93 +138,40 @@ jobs:
         run: |
           go test -race -shuffle=on -v -count=10 ./...
 
-  freebsd:
+  bsd:
     strategy:
       matrix:
+        os: ['FreeBSD', 'NetBSD']
         go: ['1.18.10', '1.19.13', '1.20.14', '1.21.13', '1.22.12', '1.23.6', '1.24.0']
-    name: Test with Go ${{ matrix.go }} on FreeBSD
+    name: Test with Go ${{ matrix.go }} on ${{ matrix.os }}
     runs-on: ubuntu-22.04
     defaults:
       run:
         shell: bash
     steps:
       - uses: actions/checkout@v4
       - name: Run in freebsd
+        if: matrix.os == 'FreeBSD'
         uses: vmactions/freebsd-vm@v1
         with:
           usesh: true
           prepare: |
             fetch https://go.dev/dl/go${{matrix.go}}.freebsd-amd64.tar.gz
             rm -fr /usr/local/go && tar -C /usr/local -xf go${{matrix.go}}.freebsd-amd64.tar.gz
             ln -s /usr/local/go/bin/go /usr/local/bin
-          run: |
-            # FreeBSD tests run within QEMU on Ubuntu.
-            # vmactions/freebsd-vm only supports a single "step" where it
-            # brings down the VM at the end of the step, so all
-            # the commands to run need to be put into this single block.
-
-            echo "Running tests on $(uname -a) at $PWD"
-
-            # verify Go is available
-            go version
-
-            echo "=> go build"
-            go build -v ./...
-            # Compile without optimization to check potential stack overflow.
-            # The option '-gcflags=all=-N -l' is often used at Visual Studio Code.
-            # See also https://go.googlesource.com/vscode-go/+/HEAD/docs/debugging.md#launch and the issue hajimehoshi/ebiten#2120.
-            go build "-gcflags=all=-N -l" -v ./...
-
-            # Check cross-compiling Windows binaries.
-            env GOOS=windows GOARCH=386 go build -v ./...
-            env GOOS=windows GOARCH=amd64 go build -v ./...
-            env GOOS=windows GOARCH=arm go build -v ./...
-            env GOOS=windows GOARCH=arm64 go build -v ./...
-
-            # Check cross-compiling macOS binaries.
-            env GOOS=darwin GOARCH=amd64 go build -v ./...
-            env GOOS=darwin GOARCH=arm64 go build -v ./...
-
-            # Check cross-compiling Linux binaries.
-            env GOOS=linux GOARCH=amd64 go build -v ./...
-            env GOOS=linux GOARCH=arm64 go build -v ./...
-
-            # Check cross-compiling FreeBSD binaries.
-            env GOOS=freebsd GOARCH=amd64 go build -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -v ./...
-            env GOOS=freebsd GOARCH=arm64 go build -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -v ./...
-
-            echo "=> go build (plugin)"
-            # Make sure that plugin buildmode works since we save the R15 register (#254)
-            go build -buildmode=plugin ./examples/libc
-
-            echo "=> go mod vendor"
-            mkdir /tmp/vendoring
-            cd /tmp/vendoring
-            go mod init foo
-            echo 'package main' > main.go
-            echo 'import (' >> main.go
-            echo '  _ "github.com/ebitengine/purego"' >> main.go
-            echo ')' >> main.go
-            echo 'func main() {}' >> main.go
-            go mod edit -replace github.com/ebitengine/purego=$GITHUB_WORKSPACE
-            go mod tidy
-            go mod vendor
-            go build -v .
-
-            cd $GITHUB_WORKSPACE
-            echo "=> go test CGO_ENABLED=0"
-            env CGO_ENABLED=0 go test -gcflags="github.com/ebitengine/purego/internal/fakecgo=-std" -shuffle=on -v -count=10 ./...
-
-            echo "=> go test CGO_ENABLED=1"
-            env CGO_ENABLED=1 go test -shuffle=on -v -count=10 ./...
-
-            echo "=> go test CGO_ENABLED=0 w/o optimization"
-            env CGO_ENABLED=0 go test "-gcflags=all=-N -l" -v ./...
-
-            echo "=> go test CGO_ENABLED=1 w/o optimization"
-            env CGO_ENABLED=1 go test "-gcflags=all=-N -l" -v ./...
-
-            if [ -z "$(echo ${{matrix.go}} | grep '^1.1')" ]; then
-              echo "=> go test race"
-              go test -race -shuffle=on -v -count=10 ./...
-            fi
+            chmod +x $GITHUB_WORKSPACE/.github/scripts/bsd_tests.sh
+          run: $GITHUB_WORKSPACE/.github/scripts/bsd_tests.sh
+      - name: Run in netbsd
+        # there are no prebuilt download links for these versions of Go for NetBSD
+        if: matrix.os == 'NetBSD' && !startsWith(matrix.go, '1.18.') && !startsWith(matrix.go, '1.19.') && !startsWith(matrix.go, '1.20.')
+        uses: vmactions/netbsd-vm@v1
+        with:
+          usesh: true
+          prepare: |
+            /usr/sbin/pkg_add -v bash
+            ftp https://go.dev/dl/go${{matrix.go}}.netbsd-amd64.tar.gz
+            mkdir /usr/local
+            rm -fr /usr/local/go && tar -C /usr/local -xf go${{matrix.go}}.netbsd-amd64.tar.gz
+            ln -s /usr/local/go/bin/go /usr/local/bin
+            chmod +x $GITHUB_WORKSPACE/.github/scripts/bsd_tests.sh
+          run: $GITHUB_WORKSPACE/.github/scripts/bsd_tests.sh

README.md

@@ -92,6 +92,7 @@ This is a list of the copied files:
 * `internal/fakecgo/iscgo.go` from package `runtime/cgo`
 * `internal/fakecgo/setenv.go` from package `runtime/cgo`
 * `internal/fakecgo/freebsd.go` from package `runtime/cgo`
+* `internal/fakecgo/netbsd.go` from package `runtime/cgo`
 
 The files `abi_*.h` and `internal/fakecgo/abi_*.h` are the same because Bazel does not support cross-package use of
 `#include` so we need each one once per package. (cf. [issue](https://github.com/bazelbuild/rules_go/issues/3636))

cgo.go

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2022 The Ebitengine Authors
 
-//go:build cgo && (darwin || freebsd || linux)
+//go:build cgo && (darwin || freebsd || linux || netbsd)
 
 package purego
 

dlerror.go

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2023 The Ebitengine Authors
 
-//go:build darwin || freebsd || linux
+//go:build darwin || freebsd || linux || netbsd
 
 package purego
 

dlfcn.go

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2022 The Ebitengine Authors
 
-//go:build (darwin || freebsd || linux) && !android && !faketime
+//go:build (darwin || freebsd || linux || netbsd) && !android && !faketime
 
 package purego
 

dlfcn_netbsd.go

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2025 The Ebitengine Authors
+
+package purego
+
+// Source for constants: https://github.com/NetBSD/src/blob/trunk/include/dlfcn.h
+
+const (
+	intSize      = 32 << (^uint(0) >> 63) // 32 or 64
+	RTLD_DEFAULT = 1<<intSize - 2         // Pseudo-handle for dlsym so search for any loaded symbol
+	RTLD_LAZY    = 0x00000001             // Relocations are performed at an implementation-dependent time.
+	RTLD_NOW     = 0x00000002             // Relocations are performed when the object is loaded.
+	RTLD_LOCAL   = 0x00000000             // All symbols are not made available for relocation processing by other modules.
+	RTLD_GLOBAL  = 0x00000100             // All symbols are available for relocation processing of other modules.
+)

dlfcn_nocgo_netbsd.go

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2025 The Ebitengine Authors
+
+package purego
+
+//go:cgo_import_dynamic purego_dlopen dlopen "libc.so"
+//go:cgo_import_dynamic purego_dlsym dlsym "libc.so"
+//go:cgo_import_dynamic purego_dlerror dlerror "libc.so"
+//go:cgo_import_dynamic purego_dlclose dlclose "libc.so"

dlfcn_stubs.s

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2022 The Ebitengine Authors
 
-//go:build darwin || !cgo && (freebsd || linux) && !faketime
+//go:build darwin || !cgo && (freebsd || linux || netbsd) && !faketime
 
 #include "textflag.h"
 

dlfcn_test.go

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2023 The Ebitengine Authors
 
-//go:build darwin || freebsd || linux
+//go:build darwin || freebsd || linux || netbsd
 
 package purego_test
 
@@ -53,12 +53,7 @@ func buildSharedLib(compilerEnv, libFile string, sources ...string) error {
 		return errors.New("compiler not found")
 	}
 
-	var args []string
-	if runtime.GOOS == "freebsd" {
-		args = []string{"-shared", "-Wall", "-Werror", "-fPIC", "-o", libFile}
-	} else {
-		args = []string{"-shared", "-Wall", "-Werror", "-o", libFile}
-	}
+	args := []string{"-shared", "-Wall", "-Werror", "-fPIC", "-o", libFile}
 	if runtime.GOARCH == "386" {
 		args = append(args, "-m32")
 	}

examples/libc/main.go

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2022 The Ebitengine Authors
 
-//go:build darwin || freebsd || linux || windows
+//go:build darwin || freebsd || linux || netbsd || windows
 
 package main
 
@@ -20,6 +20,8 @@ func getSystemLibrary() string {
 		return "libc.so.6"
 	case "freebsd":
 		return "libc.so.7"
+	case "netbsd":
+		return "libc.so"
 	case "windows":
 		return "ucrtbase.dll"
 	default:

examples/libc/main_unix.go

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2023 The Ebitengine Authors
 
-//go:build darwin || freebsd || linux
+//go:build darwin || freebsd || linux || netbsd
 
 package main
 

func.go

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2022 The Ebitengine Authors
 
-//go:build darwin || freebsd || linux || windows
+//go:build darwin || freebsd || linux || netbsd || windows
 
 package purego
 

func_test.go

@@ -17,10 +17,12 @@ func getSystemLibrary() (string, error) {
 	switch runtime.GOOS {
 	case "darwin":
 		return "/usr/lib/libSystem.B.dylib", nil
-	case "linux":
-		return "libc.so.6", nil
 	case "freebsd":
 		return "libc.so.7", nil
+	case "linux":
+		return "libc.so.6", nil
+	case "netbsd":
+		return "libc.so", nil
 	case "windows":
 		return "ucrtbase.dll", nil
 	default:

go_runtime.go

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2022 The Ebitengine Authors
 
-//go:build darwin || freebsd || linux || windows
+//go:build darwin || freebsd || linux || netbsd || windows
 
 package purego
 

internal/cgo/dlfcn_cgo_unix.go

@@ -1,12 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2024 The Ebitengine Authors
 
-//go:build freebsd || linux
+//go:build freebsd || linux || netbsd
 
 package cgo
 
 /*
- #cgo LDFLAGS: -ldl
+#cgo !netbsd LDFLAGS: -ldl
 
 #include <dlfcn.h>
 #include <stdlib.h>