[lttng-ust.git] / liblttng-ust / getenv.h

#ifndef _COMPAT_GETENV_H
#define _COMPAT_GETENV_H

/*
 * Copyright (C) 2015 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; only
 * version 2.1 of the License.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

/*
 * Always add the lttng-ust environment variables to lttng_getenv()
 * infrastructure rather than using getenv() directly from lttng-ust.
 * This ensures that we don't trigger races between getenv() invoked by
 * lttng-ust listener threads invoked concurrently with setenv() called
 * by an otherwise single-threaded application thread. (the application
 * is not aware that it runs with lttng-ust)
 */

char *lttng_getenv(const char *name);

void lttng_ust_getenv_init(void);

#endif /* _COMPAT_GETENV_H */
Commit	Line	Data
730bf2af MD	1	#ifndef _COMPAT_GETENV_H
	2	#define _COMPAT_GETENV_H
	3
	4	/*
	5	* Copyright (C) 2015 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
	6	*
	7	* This library is free software; you can redistribute it and/or
	8	* modify it under the terms of the GNU Lesser General Public
	9	* License as published by the Free Software Foundation; only
	10	* version 2.1 of the License.
	11	*
	12	* This library is distributed in the hope that it will be useful,
	13	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	14	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	15	* Lesser General Public License for more details.
	16	*
	17	* You should have received a copy of the GNU Lesser General Public
	18	* License along with this library; if not, write to the Free Software
	19	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
	20	*/
	21
6f626d28 MD	22	/*
	23	* Always add the lttng-ust environment variables to lttng_getenv()
	24	* infrastructure rather than using getenv() directly from lttng-ust.
	25	* This ensures that we don't trigger races between getenv() invoked by
	26	* lttng-ust listener threads invoked concurrently with setenv() called
	27	* by an otherwise single-threaded application thread. (the application
	28	* is not aware that it runs with lttng-ust)
	29	*/
730bf2af	30
6f626d28	31	char lttng_getenv(const char name);
730bf2af	32
6f626d28	33	void lttng_ust_getenv_init(void);
730bf2af MD	34
730bf2af MD	35	#endif /* _COMPAT_GETENV_H */