3 * Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
4 * 2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
12 * '...we will have peace, when you and all your works have perished--and
13 * the works of your dark master to whom you would deliver us. You are a
14 * liar, Saruman, and a corrupter of men's hearts.' --Théoden
16 * [p.580 of _The Lord of the Rings_, III/x: "The Voice of Saruman"]
19 /* This file contains a few functions for handling data tainting in Perl
23 #define PERL_IN_TAINT_C
27 Perl_taint_proper(pTHX_ const char *f, const char *const s)
29 /* Output a tainting violation, croaking unless we're just to warn.
30 * '_proper' is just to throw you off the scent */
32 #if defined(HAS_SETEUID) && defined(DEBUGGING)
33 PERL_ARGS_ASSERT_TAINT_PROPER;
36 const Uid_t uid = PerlProc_getuid();
37 const Uid_t euid = PerlProc_geteuid();
39 #if Uid_t_sign == 1 /* uid_t is unsigned. */
40 DEBUG_u(PerlIO_printf(Perl_debug_log,
41 "%s %d %" UVuf " %" UVuf "\n",
42 s, TAINT_get, (UV)uid, (UV)euid));
43 #else /* uid_t is signed (Uid_t_sign == -1), or don't know. */
44 DEBUG_u(PerlIO_printf(Perl_debug_log,
45 "%s %d %" IVdf " %" IVdf "\n",
46 s, TAINT_get, (IV)uid, (IV)euid));
56 if (PerlProc_getuid() != PerlProc_geteuid())
57 ug = " while running setuid";
58 else if (PerlProc_getgid() != PerlProc_getegid())
59 ug = " while running setgid";
60 else if (TAINT_WARN_get)
61 ug = " while running with -t switch";
63 ug = " while running with -T switch";
65 /* XXX because taint_proper adds extra format args, we can't
66 * get the caller to check properly; so we just silence the warning
67 * and hope the callers aren't naughty */
68 GCC_DIAG_IGNORE_STMT(-Wformat-nonliteral);
69 if (PL_unsafe || TAINT_WARN_get) {
70 Perl_ck_warner_d(aTHX_ packWARN(WARN_TAINT), f, s, ug);
73 Perl_croak(aTHX_ f, s, ug);
75 GCC_DIAG_RESTORE_STMT;
85 static const char* const misc_env[] = {
86 "IFS", /* most shells' inter-field separators */
87 "CDPATH", /* ksh dain bramage #1 */
88 "ENV", /* ksh dain bramage #2 */
89 "BASH_ENV", /* bash dain bramage -- I guess it's contagious */
91 "PERL5SHELL", /* used for system() on Windows */
96 /* Don't bother if there's no *ENV glob */
99 /* If there's no %ENV hash or if it's not magical, croak, because
100 * it probably doesn't reflect the actual environment */
101 if (!GvHV(PL_envgv) || !(SvRMAGICAL(GvHV(PL_envgv))
102 && mg_find((const SV *)GvHV(PL_envgv), PERL_MAGIC_env))) {
103 const bool was_tainted = TAINT_get;
104 const char * const name = GvENAME(PL_envgv);
106 if (strEQ(name,"ENV"))
108 taint_proper("%%ENV is aliased to %s%s", "another variable");
110 /* glob alias: report it in the error message */
111 taint_proper("%%ENV is aliased to %%%s%s", name);
112 /* this statement is reached under -t or -U */
113 TAINT_set(was_tainted);
114 #ifdef NO_TAINT_SUPPORT
115 PERL_UNUSED_VAR(was_tainted);
122 char name[10 + TYPE_DIGITS(int)] = "DCL$PATH";
123 STRLEN len = 8; /* strlen(name) */
128 len = my_snprintf(name, sizeof name, "DCL$PATH;%d", i);
129 svp = hv_fetch(GvHVn(PL_envgv), name, len, FALSE);
130 if (!svp || *svp == &PL_sv_undef)
132 if (SvTAINTED(*svp)) {
134 taint_proper("Insecure %s%s", "$ENV{DCL$PATH}");
136 if ((mg = mg_find(*svp, PERL_MAGIC_envelem)) && MgTAINTEDDIR(mg)) {
138 taint_proper("Insecure directory in %s%s", "$ENV{DCL$PATH}");
145 svp = hv_fetchs(GvHVn(PL_envgv),"PATH",FALSE);
148 if (SvTAINTED(*svp)) {
150 taint_proper("Insecure %s%s", "$ENV{PATH}");
152 if ((mg = mg_find(*svp, PERL_MAGIC_envelem)) && MgTAINTEDDIR(mg)) {
154 taint_proper("Insecure directory in %s%s", "$ENV{PATH}");
159 /* tainted $TERM is okay if it contains no metachars */
160 svp = hv_fetchs(GvHVn(PL_envgv),"TERM",FALSE);
161 if (svp && *svp && SvTAINTED(*svp)) {
163 const bool was_tainted = TAINT_get;
164 const char *t = SvPV_const(*svp, len);
165 const char * const e = t + len;
167 TAINT_set(was_tainted);
168 #ifdef NO_TAINT_SUPPORT
169 PERL_UNUSED_VAR(was_tainted);
171 if (t < e && isWORDCHAR(*t))
173 while (t < e && (isWORDCHAR(*t) || strchr("-_.+", *t)))
177 taint_proper("Insecure $ENV{%s}%s", "TERM");
182 for (e = misc_env; *e; e++) {
183 SV * const * const svp = hv_fetch(GvHVn(PL_envgv), *e, strlen(*e), FALSE);
184 if (svp && *svp != &PL_sv_undef && SvTAINTED(*svp)) {
186 taint_proper("Insecure $ENV{%s}%s", *e);
192 * ex: set ts=8 sts=4 sw=4 et: