binutils-gdb/gprofng/libcollector/tsd.h
Alan Modra 76bdc7266a Update year range in gprofng copyright notices
This adds 'Innovative Computing Labs' as an external author to
update-copyright.py, to cover the copyright notice in
gprofng/common/opteron_pcbe.c, and uses that plus another external
author 'Oracle and' to update gprofng copyright dates.  I'm not going
to commit 'Oracle and' as an accepted author, but that covers the
string "Copyright (c) 2006, 2012, Oracle and/or its affiliates. All
rights reserved." found in gprofng/testsuite/gprofng.display/jsynprog
files.
2023-01-01 23:26:30 +10:30

81 lines
2.6 KiB
C

/* Copyright (C) 2021-2023 Free Software Foundation, Inc.
Contributed by Oracle.
This file is part of GNU Binutils.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, 51 Franklin Street - Fifth Floor, Boston,
MA 02110-1301, USA. */
/* Thread-specific data */
#ifndef _TSD_H
#define _TSD_H
#include <sys/types.h>
int __collector_tsd_init ();
/* Function: Init tsd module. Call once before using other functions.
MT-Level: Unsafe
Return: 0 if successful
*/
void __collector_tsd_fini ();
/* Function: Shutdown tsd module.
MT-Level: Unsafe
Return: None
*/
void __collector_tsd_fork_child_cleanup ();
/* Function: Reset tsd module. Call immediately after fork() in child process.
MT-Level: Unsafe
Return: None
*/
int __collector_tsd_allocate ();
/* Function: Allocate thread info.
Call from threads before using tsd_get_by_key().
Call from main thread should be made before calls from other threads.
MT-Level: First call is unsafe. Safe afterwards.
Return: 0 if successful
*/
void __collector_tsd_release ();
/* Function: Free thread info.
Call from threads just before thread termination.
MT-Level: Safe
Return: None
*/
#define COLLECTOR_TSD_INVALID_KEY ((unsigned)-1)
unsigned __collector_tsd_create_key (size_t memsize, void (*init)(void*), void (*fini)(void*));
/* Function: Reserve TDS memory.
MT-Level: Unsafe
Inputs: <memsize>: number of bytes to reserve
<init>: key memory initialization. Must be callable even if
the associated thread has not yet been created.
<fini>: key memory finalization. Must be callable even if
the associated thread has been terminated.
Return: key or COLLECTOR_TSD_INVALID_KEY if not successful.
*/
void *__collector_tsd_get_by_key (unsigned key);
/* Function: Get TSD memory.
Call from threads after calling tsd_allocate().
MT-Level: Safe
Inputs: <key>: return value from tsd_create_key()
Return: memory if successful, NULL otherwise
*/
#endif /* _TSD_H */