This header file is meant to help ensure that engines and infrastructure code do not make use of certain "forbidden" APIs, such as fopen(), setjmp(), etc. More...

#include "common/scummsys.h"

Include dependency graph for forbidden.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	FORBIDDEN_SYMBOL_REPLACEMENT FORBIDDEN_look_at_common_forbidden_h_for_more_info SYMBOL !%*
	The garbage string to use as replacement for forbidden symbols. More...

#define	printf FORBIDDEN_SYMBOL_REPLACEMENT

#define	fprintf FORBIDDEN_SYMBOL_REPLACEMENT

#define	vprintf FORBIDDEN_SYMBOL_REPLACEMENT

#define	vfprintf FORBIDDEN_SYMBOL_REPLACEMENT

#define	FILE FORBIDDEN_SYMBOL_REPLACEMENT

#define	stdin FORBIDDEN_SYMBOL_REPLACEMENT

#define	stdout FORBIDDEN_SYMBOL_REPLACEMENT

#define	stderr FORBIDDEN_SYMBOL_REPLACEMENT

#define	fopen(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	fclose(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	fread(a, b, c, d) FORBIDDEN_SYMBOL_REPLACEMENT

#define	fwrite(a, b, c, d) FORBIDDEN_SYMBOL_REPLACEMENT

#define	fseek(a, b, c) FORBIDDEN_SYMBOL_REPLACEMENT

#define	ftell(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	feof(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	fgetc(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	fputc(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	fgets(a, b, c) FORBIDDEN_SYMBOL_REPLACEMENT

#define	fputs(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	getc(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	putc(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	gets(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	puts(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	getchar() FORBIDDEN_SYMBOL_REPLACEMENT

#define	putchar(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	setjmp(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	longjmp(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	system(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	exit(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	abort() FORBIDDEN_SYMBOL_REPLACEMENT

#define	getenv(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	putenv(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	setenv(a, b, c) FORBIDDEN_SYMBOL_REPLACEMENT

#define	unsetenv(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	asctime(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	clock() FORBIDDEN_SYMBOL_REPLACEMENT

#define	ctime(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	difftime(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	getdate(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	gmtime(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	localtime(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	mktime(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	time(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	chdir(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	getcwd(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	getwd(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	unlink(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isalnum(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isalpha(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	iscntrl(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isdigit(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isgraph(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isnumber(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	islower(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isprint(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	ispunct(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isspace(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isupper(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	isxdigit(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	mkdir(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	setvbuf(a, b, c, d) FORBIDDEN_SYMBOL_REPLACEMENT

#define	tmpfile() FORBIDDEN_SYMBOL_REPLACEMENT

#define	tmpnam(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	tempnam(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	rand() FORBIDDEN_SYMBOL_REPLACEMENT

#define	srand(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	random() FORBIDDEN_SYMBOL_REPLACEMENT

#define	srandom(a) FORBIDDEN_SYMBOL_REPLACEMENT

#define	stricmp(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	strnicmp(a, b, c) FORBIDDEN_SYMBOL_REPLACEMENT

#define	strcasecmp(a, b) FORBIDDEN_SYMBOL_REPLACEMENT

#define	strncasecmp(a, b, c) FORBIDDEN_SYMBOL_REPLACEMENT

#define	strdup(a) FORBIDDEN_SYMBOL_REPLACEMENT

Detailed Description

This header file is meant to help ensure that engines and infrastructure code do not make use of certain "forbidden" APIs, such as fopen(), setjmp(), etc.

This is achieved by re-#defining various symbols to a "garbage" string which then triggers a compiler error.

Backend files may #define FORBIDDEN_SYMBOL_ALLOW_ALL if they have to access functions like fopen, fread etc. Regular code, esp. code in engines/, should never do that. To ease transition, though, we allow re-enabling selected symbols in frontend code. However, this should only be used as a temporary measure. Especially new code should avoid this at all costs.

Definition in file forbidden.h.

Macro Definition Documentation

◆ abort

#define abort ( ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 210 of file forbidden.h.

◆ asctime

#define asctime ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 248 of file forbidden.h.

◆ chdir

#define chdir ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 300 of file forbidden.h.

◆ clock

#define clock ( ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 253 of file forbidden.h.

◆ ctime

#define ctime ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 258 of file forbidden.h.

◆ difftime

#define difftime	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 263 of file forbidden.h.

◆ exit

#define exit ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 205 of file forbidden.h.

◆ fclose

#define fclose ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 107 of file forbidden.h.

◆ feof

#define feof ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 132 of file forbidden.h.

◆ fgetc

#define fgetc ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 137 of file forbidden.h.

◆ fgets

#define fgets	(	a,
		b,
		c
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 147 of file forbidden.h.

◆ FILE

#define FILE FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 82 of file forbidden.h.

◆ fopen

#define fopen	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 102 of file forbidden.h.

◆ FORBIDDEN_SYMBOL_REPLACEMENT

#define FORBIDDEN_SYMBOL_REPLACEMENT FORBIDDEN_look_at_common_forbidden_h_for_more_info SYMBOL !%*

The garbage string to use as replacement for forbidden symbols.

The reason for this particular string is the following: By including a space and some non-alphanumeric symbols we trigger a compiler error. By including the words "forbidden symbol" (which the compiler will hopefully print along with its own error message), we try to make clear what is causing the error.

Definition at line 57 of file forbidden.h.

◆ fprintf

#define fprintf FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 67 of file forbidden.h.

◆ fputc

#define fputc	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 142 of file forbidden.h.

◆ fputs

#define fputs	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 152 of file forbidden.h.

◆ fread

#define fread	(	a,
		b,
		c,
		d
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 112 of file forbidden.h.

◆ fseek

#define fseek	(	a,
		b,
		c
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 122 of file forbidden.h.

◆ ftell

#define ftell ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 127 of file forbidden.h.

◆ fwrite

#define fwrite	(	a,
		b,
		c,
		d
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 117 of file forbidden.h.

◆ getc

#define getc ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 157 of file forbidden.h.

◆ getchar

#define getchar ( ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 177 of file forbidden.h.

◆ getcwd

#define getcwd	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 305 of file forbidden.h.

◆ getdate

#define getdate ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 268 of file forbidden.h.

◆ getenv

#define getenv ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 215 of file forbidden.h.

◆ gets

#define gets ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 167 of file forbidden.h.

◆ getwd

#define getwd ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 310 of file forbidden.h.

◆ gmtime

#define gmtime ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 273 of file forbidden.h.

◆ isalnum

#define isalnum ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 328 of file forbidden.h.

◆ isalpha

#define isalpha ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 333 of file forbidden.h.

◆ iscntrl

#define iscntrl ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 338 of file forbidden.h.

◆ isdigit

#define isdigit ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 343 of file forbidden.h.

◆ isgraph

#define isgraph ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 348 of file forbidden.h.

◆ islower

#define islower ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 358 of file forbidden.h.

◆ isnumber

#define isnumber ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 353 of file forbidden.h.

◆ isprint

#define isprint ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 363 of file forbidden.h.

◆ ispunct

#define ispunct ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 368 of file forbidden.h.

◆ isspace

#define isspace ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 373 of file forbidden.h.

◆ isupper

#define isupper ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 378 of file forbidden.h.

◆ isxdigit

#define isxdigit ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 383 of file forbidden.h.

◆ localtime

#define localtime ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 278 of file forbidden.h.

◆ longjmp

#define longjmp	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 194 of file forbidden.h.

◆ mkdir

#define mkdir	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 390 of file forbidden.h.

◆ mktime

#define mktime ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 283 of file forbidden.h.

◆ printf

#define printf FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 62 of file forbidden.h.

◆ putc

#define putc	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 162 of file forbidden.h.

◆ putchar

#define putchar ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 182 of file forbidden.h.

◆ putenv

#define putenv ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 220 of file forbidden.h.

◆ puts

#define puts ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 172 of file forbidden.h.

◆ rand

#define rand ( ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 423 of file forbidden.h.

◆ random

#define random ( ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 433 of file forbidden.h.

◆ setenv

#define setenv	(	a,
		b,
		c
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 225 of file forbidden.h.

◆ setjmp

#define setjmp ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 189 of file forbidden.h.

◆ setvbuf

#define setvbuf	(	a,
		b,
		c,
		d
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 402 of file forbidden.h.

◆ srand

#define srand ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 428 of file forbidden.h.

◆ srandom

#define srandom ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 438 of file forbidden.h.

◆ stderr

#define stderr FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 97 of file forbidden.h.

◆ stdin

#define stdin FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 87 of file forbidden.h.

◆ stdout

#define stdout FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 92 of file forbidden.h.

◆ strcasecmp

#define strcasecmp	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 454 of file forbidden.h.

◆ strdup

#define strdup ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 464 of file forbidden.h.

◆ stricmp

#define stricmp	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 444 of file forbidden.h.

◆ strncasecmp

#define strncasecmp	(	a,
		b,
		c
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 459 of file forbidden.h.

◆ strnicmp

#define strnicmp	(	a,
		b,
		c
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 449 of file forbidden.h.

◆ system

#define system ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 200 of file forbidden.h.

◆ tempnam

#define tempnam	(	a,
		b
	)	FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 418 of file forbidden.h.

◆ time

#define time ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 288 of file forbidden.h.

◆ tmpfile

#define tmpfile ( ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 408 of file forbidden.h.

◆ tmpnam

#define tmpnam ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 413 of file forbidden.h.

◆ unlink

#define unlink ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 315 of file forbidden.h.

◆ unsetenv

#define unsetenv ( a ) FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 230 of file forbidden.h.

◆ vfprintf

#define vfprintf FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 77 of file forbidden.h.

◆ vprintf

#define vprintf FORBIDDEN_SYMBOL_REPLACEMENT

Definition at line 72 of file forbidden.h.

Macros