...

Text file src/runtime/cgo/gcc_libinit.c

Documentation: runtime/cgo

     1// Copyright 2015 The Go Authors. All rights reserved.
     2// Use of this source code is governed by a BSD-style
     3// license that can be found in the LICENSE file.
     4
     5//go:build unix
     6
     7// When cross-compiling with clang to linux/armv5, atomics are emulated
     8// and cause a compiler warning. This results in a build failure since
     9// cgo uses -Werror. See #65290.
    10#pragma GCC diagnostic ignored "-Wpragmas"
    11#pragma GCC diagnostic ignored "-Wunknown-warning-option"
    12#pragma GCC diagnostic ignored "-Watomic-alignment"
    13
    14#include <pthread.h>
    15#include <errno.h>
    16#include <stdio.h>
    17#include <stdlib.h>
    18#include <string.h> // strerror
    19#include <time.h>
    20#include "libcgo.h"
    21#include "libcgo_unix.h"
    22
    23static pthread_cond_t runtime_init_cond = PTHREAD_COND_INITIALIZER;
    24static pthread_mutex_t runtime_init_mu = PTHREAD_MUTEX_INITIALIZER;
    25static int runtime_init_done;
    26
    27// pthread_g is a pthread specific key, for storing the g that binded to the C thread.
    28// The registered pthread_key_destructor will dropm, when the pthread-specified value g is not NULL,
    29// while a C thread is exiting.
    30static pthread_key_t pthread_g;
    31static void pthread_key_destructor(void* g);
    32uintptr_t x_cgo_pthread_key_created;
    33void (*x_crosscall2_ptr)(void (*fn)(void *), void *, int, size_t);
    34
    35// The traceback function, used when tracing C calls.
    36static void (*cgo_traceback_function)(struct cgoTracebackArg*);
    37
    38// The context function, used when tracing back C calls into Go.
    39static void (*cgo_context_function)(struct cgoContextArg*);
    40
    41// The symbolizer function, used when symbolizing C frames.
    42static void (*cgo_symbolizer_function)(struct cgoSymbolizerArg*);
    43
    44void
    45x_cgo_sys_thread_create(void* (*func)(void*), void* arg) {
    46	pthread_attr_t attr;
    47	pthread_t p;
    48	int err;
    49
    50	pthread_attr_init(&attr);
    51	pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);
    52	err = _cgo_try_pthread_create(&p, &attr, func, arg);
    53	if (err != 0) {
    54		fprintf(stderr, "pthread_create failed: %s", strerror(err));
    55		abort();
    56	}
    57}
    58
    59uintptr_t
    60_cgo_wait_runtime_init_done(void) {
    61	void (*pfn)(struct cgoContextArg*);
    62	int done;
    63
    64	pfn = __atomic_load_n(&cgo_context_function, __ATOMIC_CONSUME);
    65
    66	done = 2;
    67	if (__atomic_load_n(&runtime_init_done, __ATOMIC_CONSUME) != done) {
    68		pthread_mutex_lock(&runtime_init_mu);
    69		while (__atomic_load_n(&runtime_init_done, __ATOMIC_CONSUME) == 0) {
    70			pthread_cond_wait(&runtime_init_cond, &runtime_init_mu);
    71		}
    72
    73		// The key and x_cgo_pthread_key_created are for the whole program,
    74		// whereas the specific and destructor is per thread.
    75		if (x_cgo_pthread_key_created == 0 && pthread_key_create(&pthread_g, pthread_key_destructor) == 0) {
    76			x_cgo_pthread_key_created = 1;
    77		}
    78
    79		// TODO(iant): For the case of a new C thread calling into Go, such
    80		// as when using -buildmode=c-archive, we know that Go runtime
    81		// initialization is complete but we do not know that all Go init
    82		// functions have been run. We should not fetch cgo_context_function
    83		// until they have been, because that is where a call to
    84		// SetCgoTraceback is likely to occur. We are going to wait for Go
    85		// initialization to be complete anyhow, later, by waiting for
    86		// main_init_done to be closed in cgocallbackg1. We should wait here
    87		// instead. See also issue #15943.
    88		pfn = __atomic_load_n(&cgo_context_function, __ATOMIC_CONSUME);
    89
    90		__atomic_store_n(&runtime_init_done, done, __ATOMIC_RELEASE);
    91		pthread_mutex_unlock(&runtime_init_mu);
    92	}
    93
    94	if (pfn != nil) {
    95		struct cgoContextArg arg;
    96
    97		arg.Context = 0;
    98		(*pfn)(&arg);
    99		return arg.Context;
   100	}
   101	return 0;
   102}
   103
   104// _cgo_set_stacklo sets g->stacklo based on the stack size.
   105// This is common code called from x_cgo_init, which is itself
   106// called by rt0_go in the runtime package.
   107void _cgo_set_stacklo(G *g, uintptr *pbounds)
   108{
   109	uintptr bounds[2];
   110
   111	// pbounds can be passed in by the caller; see gcc_linux_amd64.c.
   112	if (pbounds == NULL) {
   113		pbounds = &bounds[0];
   114	}
   115
   116	x_cgo_getstackbound(pbounds);
   117
   118	g->stacklo = *pbounds;
   119
   120	// Sanity check the results now, rather than getting a
   121	// morestack on g0 crash.
   122	if (g->stacklo >= g->stackhi) {
   123		fprintf(stderr, "runtime/cgo: bad stack bounds: lo=%p hi=%p\n", (void*)(g->stacklo), (void*)(g->stackhi));
   124		abort();
   125	}
   126}
   127
   128// Store the g into a thread-specific value associated with the pthread key pthread_g.
   129// And pthread_key_destructor will dropm when the thread is exiting.
   130void x_cgo_bindm(void* g) {
   131	// We assume this will always succeed, otherwise, there might be extra M leaking,
   132	// when a C thread exits after a cgo call.
   133	// We only invoke this function once per thread in runtime.needAndBindM,
   134	// and the next calls just reuse the bound m.
   135	pthread_setspecific(pthread_g, g);
   136}
   137
   138void
   139x_cgo_notify_runtime_init_done(void* dummy __attribute__ ((unused))) {
   140	pthread_mutex_lock(&runtime_init_mu);
   141	__atomic_store_n(&runtime_init_done, 1, __ATOMIC_RELEASE);
   142	pthread_cond_broadcast(&runtime_init_cond);
   143	pthread_mutex_unlock(&runtime_init_mu);
   144}
   145
   146// Sets the traceback, context, and symbolizer functions. Called from
   147// runtime.SetCgoTraceback.
   148void x_cgo_set_traceback_functions(struct cgoSetTracebackFunctionsArg* arg) {
   149	__atomic_store_n(&cgo_traceback_function, arg->Traceback, __ATOMIC_RELEASE);
   150	__atomic_store_n(&cgo_context_function, arg->Context, __ATOMIC_RELEASE);
   151	__atomic_store_n(&cgo_symbolizer_function, arg->Symbolizer, __ATOMIC_RELEASE);
   152}
   153
   154// Gets the traceback function to call to trace C calls.
   155void (*(_cgo_get_traceback_function(void)))(struct cgoTracebackArg*) {
   156	return __atomic_load_n(&cgo_traceback_function, __ATOMIC_CONSUME);
   157}
   158
   159// Call the traceback function registered with x_cgo_set_traceback_functions.
   160//
   161// The traceback function is an arbitrary user C function which may be built
   162// with TSAN, and thus must be wrapped with TSAN acquire/release calls. For
   163// normal cgo calls, cmd/cgo automatically inserts TSAN acquire/release calls.
   164// Since the traceback, context, and symbolizer functions are registered at
   165// startup and called via the runtime, they do not get automatic TSAN
   166// acquire/release calls.
   167//
   168// The only purpose of this wrapper is to perform TSAN acquire/release.
   169// Alternatively, if the runtime arranged to safely call TSAN acquire/release,
   170// it could perform the call directly.
   171void x_cgo_call_traceback_function(struct cgoTracebackArg* arg) {
   172	void (*pfn)(struct cgoTracebackArg*);
   173
   174	pfn = _cgo_get_traceback_function();
   175	if (pfn == nil) {
   176		return;
   177	}
   178
   179	_cgo_tsan_acquire();
   180	(*pfn)(arg);
   181	_cgo_tsan_release();
   182}
   183
   184// Gets the context function to call to record the traceback context
   185// when calling a Go function from C code.
   186void (*(_cgo_get_context_function(void)))(struct cgoContextArg*) {
   187	return __atomic_load_n(&cgo_context_function, __ATOMIC_CONSUME);
   188}
   189
   190// Gets the symbolizer function to call to symbolize C frames.
   191void (*(_cgo_get_symbolizer_function(void)))(struct cgoSymbolizerArg*) {
   192	return __atomic_load_n(&cgo_symbolizer_function, __ATOMIC_CONSUME);
   193}
   194
   195// Call the symbolizer function registered with x_cgo_set_traceback_functions.
   196//
   197// See comment on x_cgo_call_traceback_function.
   198void x_cgo_call_symbolizer_function(struct cgoSymbolizerArg* arg) {
   199	void (*pfn)(struct cgoSymbolizerArg*);
   200
   201	pfn = _cgo_get_symbolizer_function();
   202	if (pfn == nil) {
   203		return;
   204	}
   205
   206	_cgo_tsan_acquire();
   207	(*pfn)(arg);
   208	_cgo_tsan_release();
   209}
   210
   211// _cgo_try_pthread_create retries pthread_create if it fails with
   212// EAGAIN.
   213int
   214_cgo_try_pthread_create(pthread_t* thread, const pthread_attr_t* attr, void* (*pfn)(void*), void* arg) {
   215	int tries;
   216	int err;
   217	struct timespec ts;
   218
   219	for (tries = 0; tries < 20; tries++) {
   220		err = pthread_create(thread, attr, pfn, arg);
   221		if (err == 0) {
   222			return 0;
   223		}
   224		if (err != EAGAIN) {
   225			return err;
   226		}
   227		ts.tv_sec = 0;
   228		ts.tv_nsec = (tries + 1) * 1000 * 1000; // Milliseconds.
   229		nanosleep(&ts, nil);
   230	}
   231	return EAGAIN;
   232}
   233
   234static void
   235pthread_key_destructor(void* g) {
   236	if (x_crosscall2_ptr != NULL) {
   237		// fn == NULL means dropm.
   238		// We restore g by using the stored g, before dropm in runtime.cgocallback,
   239		// since the g stored in the TLS by Go might be cleared in some platforms,
   240		// before this destructor invoked.
   241		x_crosscall2_ptr(NULL, g, 0, 0);
   242	}
   243}

View as plain text