v0.8.2 ef7c59a

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

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