1N/A/*********************************************************************** 1N/A* This software is part of the ast package * 1N/A* Copyright (c) 1982-2011 AT&T Intellectual Property * 1N/A* and is licensed under the * 1N/A* Common Public License, Version 1.0 * 1N/A* by AT&T Intellectual Property * 1N/A* A copy of the License is available at * 1N/A* (with md5 checksum 059e8cd6165cb4c31e351f2b69388fd9) * 1N/A* Information and Software Systems Research * 1N/A* David Korn <dgk@research.att.com> * 1N/A***********************************************************************/ 1N/A * regression test intercept control 1N/A * enable with SHOPT_REGRESS==1 in Makefile 1N/A * not for production use 1N/A * see --man for details 1N/A * all string constants inline here instead of in data/... 1N/A"[-1p0?\n@(#)$Id: __regress__ (AT&T Research) 2009-03-29 $\n]" 1N/A"[+NAME?__regress__ - shell regression test intercept control]" 1N/A"[+DESCRIPTION?\b__regress__\b controls the regression test intercepts " 1N/A "for shells compiled with SHOPT_REGRESS==1. Shells compiled this way are " 1N/A "for testing only. In addition to \b__regress__\b and the \b--regress\b " 1N/A "command line option, these shells may contain system library function " 1N/A "intercepts that behave different from the native counterparts.]" 1N/A"[+?Each option controls a different test and possibly a different set " 1N/A "of intercepts. The options are interpreted \bdd\b(1) style -- '-' or " 1N/A "'--' prefix not required. This simplifies the specification of the " 1N/A "command line \b--regress\b=\avalue\a option, where \avalue\a is passed " 1N/A "as an option to the \b__regress__\b builtin. Typically regression test " 1N/A "intercepts are enabled with one or more command line \b--regress\b " 1N/A "options, with optional specific calls to \b__regress__\b in test " 1N/A "\aoption\a:\aintercept\a:\ainfo\a on the standard error, where " 1N/A "\aoption\a is one of the options below, \aintercept\a is the name of " 1N/A "the specific intercept for \aoption\a, and \ainfo\a is \aoption\a " 1N/A "specific information. Unless noted otherwise, one regression test trace " 1N/A "line is produced each time an enabled intercept is called.]" 1N/A"[101:egid?The intercept effective gid is set to \aoriginal-egid\a. The " 1N/A "effective gid of the underlying system process is not affected. The " 1N/A "trace line info is either \begid==rgid\b or \begid!=rgid\b. The " 1N/A "intercepts are:]#?[original-egid:=1]" 1N/A "[+getegid()?The intercept effecive gid is returned. The " 1N/A "\bsetgid\b() intercept may change this between the real gid and " 1N/A "\aoriginal-egid\a.]" 1N/A "[+setgid(gid)?Sets the intercept effective gid to \agid\a. " 1N/A "Fails if \agid\a is neither the real gid nor " 1N/A "\aoriginal-egid\a.]" 1N/A"[102:euid?The intercept effective uid is set to \aoriginal-euid\a. The " 1N/A "effective uid of the underlying system process is not affected. The " 1N/A "trace line info is either \beuid==ruid\b or \beuid!=ruid\b. The " 1N/A "intercepts are:]#?[original-euid:=1]" 1N/A "[+geteuid()?The intercept effecive uid is returned. The " 1N/A "\bsetuid\b() intercept may change this between the real uid and " 1N/A "\aoriginal-euid\a.]" 1N/A "[+setuid(uid)?Sets the intercept effective uid to \auid\a. " 1N/A "Fails if \auid\a is neither the real uid nor " 1N/A "\aoriginal-euid\a.]" 1N/A"[103:p_suid?Specifies a value for SHOPT_P_SUID. Effective uids greater " 1N/A "than the non-privileged-uid disable the priveleged mode. The intercepts " 1N/A "are:]#?[non-privileged-uid:=1]" 1N/A "[+SHOPT_P_SUID?The SHOPT_P_SUID macro value is overridden by " 1N/A "\bp_suid\b. A trace line is output for each SHOPT_P_SUID " 1N/A"[104:source?The intercepts are:]" 1N/A "[+sh_source()?The trace line info is the path of the script " 1N/A "being sourced. Used to trace shell startup scripts.]" 1N/A"[105:etc?Map file paths matching \b/etc/\b* to \aetc-dir\a/*. The " 1N/A "intercepts are:]:[etc-dir:=/etc]" 1N/A "[+sh_open()?Paths matching \b/etc/\b* are changed to " 1N/A"[+SEE ALSO?\bksh\b(1), \bregress\b(1), \brt\b(1)]" 1N/A * regress info trace output 1N/A * __regress__ builtin