Some implementations provide a nonportable environment pointer that is valid when main()
is called but may be invalidated by operations that modify the environment.
The C Standard, J.5.1 2 [ISO/IEC 9899:20112024], states
In a hosted environment, the main function receives a third argument, char *envp[], that points to a null-terminated array of pointers to char, each of which points to a string that provides information about the environment for this execution of the program (5.1.2.3.2).
Consequently, under a hosted environment supporting this common extension, it is possible to access the environment through a modified form of main()
:
...
Because envp
may no longer point to the current environment, this program has undefined unanticipated behavior.
Compliant Solution (POSIX)
...
Because envp
no longer points to the current environment, this program has undefined unanticipated behavior.
Compliant Solution (Windows)
...
Tool | Version | Checker | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Astrée |
| Supported | |||||||||||||||||
Compass/ROSE | |||||||||||||||||||
Cppcheck Premium | 24.9.0 | premium-cert-env31-c | Fully implemented | ||||||||||||||||
Helix QAC |
| DF4991, DF4992, DF4993 | |||||||||||||||||
LDRA tool suite |
| 118 S | Fully Implemented | ||||||||||||||||
Parasoft C/C++test |
| CERT_C-ENV31-a | Do not rely on an environment pointer following an operation that may invalidate it | ||||||||||||||||
| Environment CERT C: Rule ENV31-C | Checks for environment pointer invalidated by previous operation | Call to setenv or putenv family function modifies environment pointed to by pointer | PRQA QA-C | |||||||||||||||
Include Page | PRQA QA-C_v | PRQA QA-C_v | 4991, 4992, 4993 | (rule fully covered) |
Related Vulnerabilities
Search for vulnerabilities resulting from the violation of this rule on the CERT website.
...
[IEEE Std 1003.1:2013] | XSH, System Interfaces, setenv |
[ISO/IEC 9899:20112024] | J.5.12, "Environment Arguments" |
[MSDN] | , ,
getenv , _wgetenv ,_putenv_s , _wputenv_s |
...