cybercyst/go
1
0
Fork 0
mirror of https://github.com/golang/go.git synced 2025-05-05 15:43:04 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Drop the suggestion to use the included C compiler, since it is no longer included. Change "Plan 9 assembler" to "cmd/asm".

Ian Lance Taylor 2017-01-06 14:56:39 -08:00
parent 7163f4cbf8
commit a83b0429b2
1 changed files with 2 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
GcToolchainTricks.md

@ -1,20 +1,16 @@
_**Update: the Plan 9 C compilers are going away in future releases of Go (scheduled in Go 1.5), so some of the tricks below that use them are deprecated.**_
# Introduction
This page documents some less well-known (perhaps advanced) tricks for the ` gc ` toolchain (and the Go tool).
# C code without ` cgo `
### Use the bundled Plan 9 C Compiler ` 6c `
Dave Cheney has written an excellent blog post about this: http://dave.cheney.net/2013/09/07/how-to-include-c-code-in-your-go-package
### Use ` syso ` file to embed arbitrary self-contained C code
Basically, you write your assembly language in GNU as(1) format, but make sure
all the interface functions are using Go's ABI (everything on stack, etc., please read [Go 1.2 Assembler Introduction](http://golang.org/doc/asm) for more details).
all the interface functions are using Go's ABI (everything on stack, etc., please read [Go 1.2 Assembler Introduction](https://golang.org/doc/asm) for more details).
The most important step is compiling that file to file.syso (` gcc -c -O3 -o file.syso file.S `),
and put the resulting syso in the package source directory.
And then, suppose your assembly function is named Func, you need one stub
Plan 9 assembly file to call it:
[cmd/asm](https://golang.org/cmd/asm) assembly file to call it:
```
TEXT ·Func(SB),$0-8 // please set the correct parameter size (8) here
JMP Func(SB)