1/****************************************************************************
2 * Copyright 2021,2023 Thomas E. Dickey                                     *
3 *                                                                          *
4 * Permission is hereby granted, free of charge, to any person obtaining a  *
5 * copy of this software and associated documentation files (the            *
6 * "Software"), to deal in the Software without restriction, including      *
7 * without limitation the rights to use, copy, modify, merge, publish,      *
8 * distribute, distribute with modifications, sublicense, and/or sell       *
9 * copies of the Software, and to permit persons to whom the Software is    *
10 * furnished to do so, subject to the following conditions:                 *
11 *                                                                          *
12 * The above copyright notice and this permission notice shall be included  *
13 * in all copies or substantial portions of the Software.                   *
14 *                                                                          *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
16 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
18 * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
19 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
20 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
21 * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
22 *                                                                          *
23 * Except as contained in this notice, the name(s) of the above copyright   *
24 * holders shall not be used in advertising or otherwise to promote the     *
25 * sale, use or other dealings in this Software without prior written       *
26 * authorization.                                                           *
27 ****************************************************************************/
28
29/* $Id: nc_access.h,v 1.1 2023/10/17 09:52:08 nicm Exp $ */
30
31#ifndef NC_ACCESS_included
32#define NC_ACCESS_included 1
33/* *INDENT-OFF* */
34
35#include <ncurses_cfg.h>
36#include <curses.h>
37#include <sys/types.h>
38
39#ifdef __cplusplus
40extern "C" {
41#endif
42
43/*
44 * Turn off the 'use_terminfo_vars()' symbol to limit access to environment
45 * variables when running with privileges.
46 */
47#if defined(USE_ROOT_ENVIRON) && defined(USE_SETUID_ENVIRON)
48#define use_terminfo_vars() 1
49#else
50#define use_terminfo_vars() _nc_env_access()
51#endif
52
53extern NCURSES_EXPORT(int) _nc_env_access (void);
54
55/*
56 * Turn off this symbol to limit access to files when running setuid.
57 */
58#ifdef USE_ROOT_ACCESS
59
60#define safe_fopen(name,mode)       fopen(name,mode)
61#define safe_open2(name,flags)      open(name,flags)
62#define safe_open3(name,flags,mode) open(name,flags,mode)
63
64#else
65
66#define safe_fopen(name,mode)       _nc_safe_fopen(name,mode)
67#define safe_open2(name,flags)      _nc_safe_open3(name,flags,0)
68#define safe_open3(name,flags,mode) _nc_safe_open3(name,flags,mode)
69extern NCURSES_EXPORT(FILE *)       _nc_safe_fopen (const char *, const char *);
70extern NCURSES_EXPORT(int)          _nc_safe_open3 (const char *, int, mode_t);
71
72#endif
73
74#ifdef __cplusplus
75}
76#endif
77
78/* *INDENT-ON* */
79
80#endif /* NC_ACCESS_included */
81