diff options
Diffstat (limited to 'src/runtime/funcdata.h')
-rw-r--r-- | src/runtime/funcdata.h | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/src/runtime/funcdata.h b/src/runtime/funcdata.h new file mode 100644 index 000000000..d6c14fcb4 --- /dev/null +++ b/src/runtime/funcdata.h @@ -0,0 +1,60 @@ +// Copyright 2013 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// This file defines the IDs for PCDATA and FUNCDATA instructions +// in Go binaries. It is included by both C and assembly, so it must +// be written using #defines. It is included by the runtime package +// as well as the compilers. +// +// symtab.go also contains a copy of these constants. + +#define PCDATA_StackMapIndex 0 + +#define FUNCDATA_ArgsPointerMaps 0 /* garbage collector blocks */ +#define FUNCDATA_LocalsPointerMaps 1 +#define FUNCDATA_DeadValueMaps 2 + +// Pseudo-assembly statements. + +// GO_ARGS, GO_RESULTS_INITIALIZED, and NO_LOCAL_POINTERS are macros +// that communicate to the runtime information about the location and liveness +// of pointers in an assembly function's arguments, results, and stack frame. +// This communication is only required in assembly functions that make calls +// to other functions that might be preempted or grow the stack. +// NOSPLIT functions that make no calls do not need to use these macros. + +// GO_ARGS indicates that the Go prototype for this assembly function +// defines the pointer map for the function's arguments. +// GO_ARGS should be the first instruction in a function that uses it. +// It can be omitted if there are no arguments at all. +// GO_ARGS is inserted implicitly by the linker for any function +// that also has a Go prototype and therefore is usually not necessary +// to write explicitly. +#define GO_ARGS FUNCDATA $FUNCDATA_ArgsPointerMaps, go_args_stackmap(SB) + +// GO_RESULTS_INITIALIZED indicates that the assembly function +// has initialized the stack space for its results and that those results +// should be considered live for the remainder of the function. +#define GO_RESULTS_INITIALIZED FUNCDATA PCDATA $PCDATA_StackMapIndex, 1 + +// NO_LOCAL_POINTERS indicates that the assembly function stores +// no pointers to heap objects in its local stack variables. +#define NO_LOCAL_POINTERS FUNCDATA $FUNCDATA_LocalsPointerMaps, runtime·no_pointers_stackmap(SB) + +// ArgsSizeUnknown is set in Func.argsize to mark all functions +// whose argument size is unknown (C vararg functions, and +// assembly code without an explicit specification). +// This value is generated by the compiler, assembler, or linker. +#define ArgsSizeUnknown 0x80000000 + +/*c2go +enum { + PCDATA_ArgSize = 0, + PCDATA_StackMapIndex = 1, + FUNCDATA_ArgsPointerMaps = 0, + FUNCDATA_LocalsPointerMaps = 1, + FUNCDATA_DeadValueMaps = 2, + ArgsSizeUnknown = 0x80000000, +}; +*/ |