Add examples/syscall/syscall

examples/syscall/syscall/.gitignore

@@ -0,0 +1 @@
+app

examples/syscall/syscall/README.md

@@ -0,0 +1,16 @@
+# これは何？
+
+[unix](https://pkg.go.dev/golang.org/x/sys/unix) パッケージの
+
+- Syscall()
+
+を使っているサンプルです。
+
+```sh
+$ task
+task: [default] rm -f ./app
+task: [default] go build -o app .
+task: [default] ./app
+[syscall] r1=31142, r2=0
+[pid    ] syscall=31142, os=31142
+```

examples/syscall/syscall/Taskfile.yml

@@ -0,0 +1,10 @@
+# https://taskfile.dev
+
+version: '3'
+
+tasks:
+  default:
+    cmds:
+      - rm -f ./app
+      - go build -o app .
+      - ./app

examples/syscall/syscall/main.go

@@ -0,0 +1,51 @@
+//go:build linux
+
+package main
+
+import (
+	"fmt"
+	"log"
+	"os"
+
+	"golang.org/x/sys/unix"
+)
+
+func main() {
+	log.SetFlags(0)
+	if err := run(); err != nil {
+		log.Fatal(err)
+	}
+}
+
+func run() error {
+	//
+	// unix.Syscall() のサンプル
+	//
+	// unix.Syscall(), unix.Syscall6() は、指定したシステムコールを呼び出すための関数。
+	//
+	// unix.Syscall() は引数が３つ指定できるシステムコール呼び出し関数。
+	// これより多い場合は６つ指定できる unix.Syscall6() を利用する。
+	//
+
+	//
+	// getpid(2)
+	// getpid(2)は引数が無い関数 (pid_t getpid(void);)
+	//
+	const (
+		ZERO uintptr = 0 // unix.Syscall()で指定する際に利用する不要な引数値
+	)
+	var (
+		trap   uintptr = unix.SYS_GETPID
+		r1, r2 uintptr
+		err    unix.Errno // unix.Syscall()の場合は error ではなく unix.Errno であることに注意
+	)
+	r1, r2, err = unix.Syscall(trap, ZERO, ZERO, ZERO)
+	if err != 0 {
+		return fmt.Errorf("getpid: %d", err)
+	}
+
+	log.Printf("[syscall] r1=%d, r2=%d", r1, r2)
+	log.Printf("[pid    ] syscall=%d, os=%d", r1, os.Getpid())
+
+	return nil
+}