v0.8.4 a52bc83

gen.go RawHistoryFolder

1// SPDX-License-Identifier: Apache-2.0
2// SPDX-FileCopyrightText: 2022 The Ebitengine Authors
3
4//go:build ignore
5
6package main
7
8import (
9	"bytes"
10	"fmt"
11	"go/format"
12	"log"
13	"os"
14	"strings"
15	"text/template"
16)
17
18const templateSymbols = `// Code generated by 'go generate' with gen.go. DO NOT EDIT.
19
20// SPDX-License-Identifier: Apache-2.0
21// SPDX-FileCopyrightText: 2022 The Ebitengine Authors
22
23//go:build !cgo && (darwin || freebsd || linux)
24
25package fakecgo
26
27import (
28	"syscall"
29	"unsafe"
30)
31
32// setg_trampoline calls setg with the G provided
33func setg_trampoline(setg uintptr, G uintptr)
34
35// call5 takes fn the C function and 5 arguments and calls the function with those arguments
36func call5(fn, a1, a2, a3, a4, a5 uintptr) uintptr
37
38{{ range . -}}
39//go:nosplit
40//go:norace
41func {{.Name}}(
42{{- range .Args -}}
43	{{- if .Name -}}
44		{{.Name}} {{.Type}},
45	{{- end -}}
46{{- end -}}) {{.Return}} {
47	{{- if .Return -}}
48		{{- if eq .Return "unsafe.Pointer" -}}
49			ret :=
50		{{- else -}}
51			return {{.Return}}(
52		{{- end -}}
53	{{- end -}}
54call5({{.Name}}ABI0,
55{{- range .Args}}
56	{{- if .Name -}}
57		{{- if hasPrefix .Type "*" -}}
58			uintptr(unsafe.Pointer({{.Name}})),
59		{{- else -}}
60			uintptr({{.Name}}),
61		{{- end -}}
62	{{- else -}}
63		0,
64	{{- end -}}
65{{- end -}}
66	) {{/* end of call5 */}}
67{{- if .Return -}}
68	{{- if eq .Return "unsafe.Pointer"}}
69		// this indirection is to avoid go vet complaining about possible misuse of unsafe.Pointer
70		return *(*unsafe.Pointer)(unsafe.Pointer(&ret))
71	{{- else -}}
72		) {{/* end of cast */}}
73	{{- end -}}
74{{- end}}
75}
76
77{{end}}
78{{- range . }}
79//go:linkname _{{.Name}} _{{.Name}}
80var _{{.Name}} uint8
81var {{.Name}}ABI0 = uintptr(unsafe.Pointer(&_{{.Name}}))
82{{ end }}
83`
84
85const templateTrampolinesStubs = `// Code generated by 'go generate' with gen.go. DO NOT EDIT.
86
87// SPDX-License-Identifier: Apache-2.0
88// SPDX-FileCopyrightText: 2022 The Ebitengine Authors
89
90//go:build !cgo && (darwin || freebsd || linux)
91
92#include "textflag.h"
93
94// these stubs are here because it is not possible to go:linkname directly the C functions on darwin arm64
95{{ range . }}
96TEXT _{{.Name}}(SB), NOSPLIT|NOFRAME, $0-0
97	JMP purego_{{.Name}}(SB)
98	RET
99{{ end -}}
100`
101
102const templateSymbolsGoos = `// Code generated by 'go generate' with gen.go. DO NOT EDIT.
103
104// SPDX-License-Identifier: Apache-2.0
105// SPDX-FileCopyrightText: 2022 The Ebitengine Authors
106
107//go:build !cgo
108
109package fakecgo
110
111{{- range $location := . }}
112{{- range .Symbols }}
113//go:cgo_import_dynamic purego_{{ .Name }} {{ .Name }} "{{ $location.SharedObject }}"
114{{- end }}
115{{- end }}
116`
117
118type Arg struct {
119	Name string
120	Type string
121}
122
123type Symbol struct {
124	Name   string
125	Args   [5]Arg
126	Return string
127}
128
129type LocatedSymbols struct {
130	SharedObject string
131	Symbols      []Symbol
132}
133
134var (
135	libcSymbols = []Symbol{
136		{"malloc", [5]Arg{{"size", "uintptr"}}, "unsafe.Pointer"},
137		{"free", [5]Arg{{"ptr", "unsafe.Pointer"}}, ""},
138		{"setenv", [5]Arg{{"name", "*byte"}, {"value", "*byte"}, {"overwrite", "int32"}}, "int32"},
139		{"unsetenv", [5]Arg{{"name", "*byte"}}, "int32"},
140		{"sigfillset", [5]Arg{{"set", "*sigset_t"}}, "int32"},
141		{"nanosleep", [5]Arg{{"ts", "*syscall.Timespec"}, {"rem", "*syscall.Timespec"}}, "int32"},
142		{"abort", [5]Arg{}, ""},
143	}
144	pthreadSymbols = []Symbol{
145		{"pthread_attr_init", [5]Arg{{"attr", "*pthread_attr_t"}}, "int32"},
146		{"pthread_create", [5]Arg{{"thread", "*pthread_t"}, {"attr", "*pthread_attr_t"}, {"start", "unsafe.Pointer"}, {"arg", "unsafe.Pointer"}}, "int32"},
147		{"pthread_detach", [5]Arg{{"thread", "pthread_t"}}, "int32"},
148		{"pthread_sigmask", [5]Arg{{"how", "sighow"}, {"ign", "*sigset_t"}, {"oset", "*sigset_t"}}, "int32"},
149		{"pthread_self", [5]Arg{}, "pthread_t"},
150		{"pthread_get_stacksize_np", [5]Arg{{"thread", "pthread_t"}}, "size_t"},
151		{"pthread_attr_getstacksize", [5]Arg{{"attr", "*pthread_attr_t"}, {"stacksize", "*size_t"}}, "int32"},
152		{"pthread_attr_setstacksize", [5]Arg{{"attr", "*pthread_attr_t"}, {"size", "size_t"}}, "int32"},
153		{"pthread_attr_destroy", [5]Arg{{"attr", "*pthread_attr_t"}}, "int32"},
154		{"pthread_mutex_lock", [5]Arg{{"mutex", "*pthread_mutex_t"}}, "int32"},
155		{"pthread_mutex_unlock", [5]Arg{{"mutex", "*pthread_mutex_t"}}, "int32"},
156		{"pthread_cond_broadcast", [5]Arg{{"cond", "*pthread_cond_t"}}, "int32"},
157		{"pthread_setspecific", [5]Arg{{"key", "pthread_key_t"}, {"value", "unsafe.Pointer"}}, "int32"},
158	}
159)
160
161var funcs = map[string]any{
162	"hasPrefix": strings.HasPrefix,
163}
164
165func run() error {
166	t, err := template.New("symbol.go").Funcs(funcs).Parse(templateSymbols)
167	if err != nil {
168		return err
169	}
170	f, err := os.Create("symbols.go")
171	defer f.Close()
172	if err != nil {
173		return err
174	}
175	allSymbols := append(append([]Symbol{}, libcSymbols...), pthreadSymbols...)
176	buf := new(bytes.Buffer)
177	if err := t.Execute(buf, allSymbols); err != nil {
178		return err
179	}
180	source, err := format.Source(buf.Bytes())
181	if err != nil {
182		return err
183	}
184	if _, err = f.Write(source); err != nil {
185		return err
186	}
187	t, err = template.New("trampolines_stubs.s").Funcs(funcs).Parse(templateTrampolinesStubs)
188	if err != nil {
189		return err
190	}
191	f, err = os.Create("trampolines_stubs.s")
192	defer f.Close()
193	if err != nil {
194		return err
195	}
196	if err := t.Execute(f, allSymbols); err != nil {
197		return err
198	}
199	t, err = template.New("symbols_goos.go").Parse(templateSymbolsGoos)
200	if err != nil {
201		return err
202	}
203	for _, goos := range []string{"darwin", "linux", "freebsd"} {
204		f, err = os.Create(fmt.Sprintf("symbols_%s.go", goos))
205		defer f.Close()
206		if err != nil {
207			return err
208		}
209		b := &bytes.Buffer{}
210		var libcSO, pthreadSO string
211		switch goos {
212		case "darwin":
213			libcSO = "/usr/lib/libSystem.B.dylib"
214			pthreadSO = "/usr/lib/libSystem.B.dylib"
215		case "freebsd":
216			libcSO = "libc.so.7"
217			pthreadSO = "libpthread.so"
218		case "linux":
219			libcSO = "libc.so.6"
220			pthreadSO = "libpthread.so.0"
221		default:
222			return fmt.Errorf("unsupported OS: %s", goos)
223		}
224		located := []LocatedSymbols{
225			{SharedObject: libcSO, Symbols: libcSymbols},
226			{SharedObject: pthreadSO, Symbols: pthreadSymbols},
227		}
228		if err = t.Execute(b, located); err != nil {
229			return err
230		}
231		var src []byte
232		src, err = format.Source(b.Bytes())
233		if err != nil {
234			return err
235		}
236		if _, err = f.Write(src); err != nil {
237			return err
238		}
239	}
240	return nil
241}
242
243func main() {
244	if err := run(); err != nil {
245		log.Fatal(err)
246	}
247}

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 102

↑↓ moveenter openesc close