Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated reference from C11->C23.

An Every object has a storage duration that determines its lifetime. There are three storage durations: static, threadautomatic, and or allocated.

According to the C Standard, section 6.2.4, paragraph 2 [ISO/IEC 9899:20112024],

The lifetime of an object is the portion of program execution during which storage is guaranteed to be reserved for it. An object exists, has a constant address, and retains its last-stored value throughout its lifetime. If an object is referred to outside of its lifetime, the behavior is undefined. The value of If a pointer becomes indeterminate when value is used in an evaluation after the object it the pointer points to (or just past) reaches the end of its lifetime, the behavior is undefined.

Attempting Do not attempt to access an object outside of its lifetime can result in . Attempting to do so is undefined behavior and can lead to an exploitable vulnerability. (See also undefined behavior 9  of Appendix in the C Standard, Annex J.)

Noncompliant Code Example (

...

Differing Storage Durations)

In this noncompliant code sampleexample, the address of local the variable c_str with automatic storage duration is assigned to the variable p, which has file scopestatic storage duration. The assignment itself is legalvalid, but it is illegal invalid for c_str to go out of scope while p holds its address, as happens at the end of dont_do_this().

Code Block
bgColor#FFCCCC
langc
#include <stdio.h>
 
const char *p;
void dont_do_this(void) {
    const char c_str[] = "This will change";
    p = c_str; /* dangerous */
    /* ...Dangerous */
}

void innocuous(void) {
    const char str[] = "Surprise, surprise"printf("%s\n", p);
}

/* ... */
int main(void) {
  dont_do_this();
  innocuous();
/* p might be pointing to "Surprise, surprise" */
return 0;
}

Compliant Solution (

...

Same Storage Durations)

In this compliant solution, p is declared with the same scope storage duration as c_str, preventing p from taking on an indeterminate value outside of this_is_OK().:

Code Block
bgColor#ccccff
langc
void this_is_OK(void) {
    const char c_str[] = "Everything OK";
    const char *p = c_str;
    /* ... */
}
/* p is inaccessible outside the scope of string c_str */

AlternatelyAlternatively, both p and c_str could be declared with static scopestorage duration.

Compliant Solution (Differing

...

Storage Durations)

If it is necessary for p to be defined with file scope, but with static storage duration but c_str with a more limited scopeduration, then p can be set to NULL before c_str is destroyed. This practice prevents p from taking on an indeterminate value, although any references to p must check for NULL.

Code Block
bgColor#ccccff
langc
const char *p;
void is_this_OK(void) {
    const char c_str[] = "Everything OK?";
    p = c_str;
    /* ... */
    p = NULL;
}

Noncompliant Code Example (Return Values)

In this noncompliant code sample, the function init_array() returns a pointer to a local stack variable, which could be accessed by the caller.character array with automatic storage duration, which is accessible to the caller:

Code Block
bgColor#FFCCCC
langc
char *init_array(void) {
   char array[10];
   /* Initialize array */
   return array;
}

Some compilers generate a warning diagnostic message when a pointer to an object with automatic variable storage duration is returned from a function, as in this example. Compile your Programmers should compile code at high warning levels and resolve any warningsdiagnostic messages. (See MSC00-C. Compile cleanly at high warning levels.)

...

The solution, in this case, depends on the intent of the programmer. If the intent is to modify the value of array and have that modification persist outside of the scope of init_array(), the desired behavior can be achieved by declaring array elsewhere and passing it as an argument to init_array().:

Code Block
bgColor#ccccff
langc
#include <stddef.h>
void init_array(char array[]*array, size_t len) {
   /* Initialize array */
   return;
}

int main(int argc, char *argv[]void) {
   char array[10];
   init_array(array, sizeof(array) / sizeof(array[0]));
   /* ... */
   return 0;
}

Noncompliant Code Example (Output Parameter)

In this noncompliant code sampleexample, the function squirrel_away() stores a pointer to local stack variable local into a location pointed to by function parameter ptr_param. Since it can be assumed that the pointer variable to which ptr_param points remains alive upon Upon the return of squirrel_away()'s return, it is illegal for local to go out of scope, the pointer ptr_param points to a variable that has an expired lifetime.

Code Block
bgColor#FFcccc
langc
void squirrel_away(char **ptr_param) {
   char local[10];
   /* Initialize array */
   *ptr_param = local;
}

void rodent(void) {
  char *ptr;
  squirrel_away(&ptr);
  /* ptr is live but invalid here */
}

Compliant Solution (Output Parameter)

In this compliant solution, the variable local has static storage duration; consequently, ptr can be used to reference the local array within the rodent() function:

Code Block
bgColor#ccccff
langc
char local[10];
 
void squirrel_away(char **ptr_param) {
  /* Initialize array */
  *ptr_param = local;
}

void rodent(void) {
  char *ptr;
  squirrel_away(&ptr);
  /* ptr is valid in this scope */
}

Risk Assessment

Referencing an object outside of its lifetime can result in an attacker being able to run execute arbitrary code.

Rule

Severity

Likelihood

Remediation Cost

Priority

Level

DCL30-C

high

High

probable

Probable

high

High

P6

L2

Automated Detection

Tool

Version

Checker

Description

LDRA tool suite
Astrée
Include Page
LDRA
Astrée_V
LDRA
Astrée_V

42 D
71 S

Fully implemented.

Fortify SCA

V. 7.6.0

 

Can detect violations when an array is declared in a function and then a pointer to that array is returned.

Splint Include PageSplint_VSplint_V  Compass/ROSE 

pointered-deallocation

return-reference-local

Fully checked
Axivion Bauhaus Suite

Include Page
Axivion Bauhaus Suite_V
Axivion Bauhaus Suite_V

CertC-DCL30Fully implemented
CodeSonar
Include Page
CodeSonar_V
CodeSonar_V
LANG.STRUCT.RPLReturns pointer to local
Compass/ROSE
 


Can detect violations of this rule. It automatically detects returning pointers to local variables. Detecting more general cases, such as examples where static pointers are set to local variables which then go out of scope, would be difficult

.

Coverity

Include Page
Coverity_V
Coverity_V

RETURN_LOCAL

Finds many instances where a function will return a pointer to a local stack variable. Coverity Prevent cannot discover all violations of this rule, so further verification is necessary

.

Cppcheck

Include Page
Cppcheck_V
Cppcheck_V

danglingLifetime
returnDanglingLifetime
autoVariables
invalidLifetime

Fully implemented

Cppcheck Premium

Include Page
Cppcheck Premium_V
Cppcheck Premium_V

danglingLifetime
returnDanglingLifetime
autoVariables
invalidLifetime

Fully implemented

Helix QAC

Include Page
Helix QAC_V
Helix QAC_V

C3217, C3225, C3230, C4140

C++2515, C++2516, C++2527, C++2528, C++4026, C++4624, C++4629

Fully implemented
Klocwork
Include Page
Klocwork_V
Klocwork_V

LOCRET.ARG
LOCRET.

*

GLOB

LOCRET.RET
Fully implemented
LDRA tool suite
Include Page
LDRA_V
LDRA_V

42 D, 77 D, 71 S, 565 S

Enhanced Enforcement
Parasoft C/C++test
Include Page
Parasoft_V
Parasoft_V

CERT_C-DCL30-a
CERT_C-DCL30-b

The address of an object with automatic storage shall not be returned from a function
The address of an object with automatic storage shall not be assigned to another object that may persist after the first object has ceased to exist

PC-lint Plus

Include Page
PC-lint Plus_V
PC-lint Plus_V

604, 674, 733, 789

Partially supported

Polyspace Bug Finder

Include Page
Polyspace Bug Finder_V
Polyspace Bug Finder_V

CERT C: Rule DCL30-C


Checks for pointer or reference to stack variable leaving scope (rule fully covered)

PVS-Studio

Include Page
PVS-Studio_V
PVS-Studio_V

V506, V507, V558, V623, V723, V738


RuleChecker
Include Page
RuleChecker_V
RuleChecker_V
return-reference-local
Partially checked
Splint
Include Page
Splint_V
Splint_V


TrustInSoft Analyzer

Include Page
TrustInSoft Analyzer_V
TrustInSoft Analyzer_V

dangling_pointer

Exhaustively detects undefined behavior (see one compliant and one non-compliant example).

 PRQA QA-C Include PagePRQA_VPRQA_V3217Partially implemented  3225   3230   4140 

Related Vulnerabilities

Search for vulnerabilities resulting from the violation of this rule on the CERT website.

Related Guidelines

Key here (explains table format and definitions)

Taxonomy

Taxonomy item

Relationship

CERT C

...

ISO/IEC 9899:2011 Section 6.2.4, "Storage durations of objects," and section 7.22.3, "Memory management functions"

...

...

MSC00-C. Compile cleanly at high warning levelsPrior to 2018-01-12: CERT: Unspecified Relationship
CERT CEXP54-CPP. Do not access an object outside of its lifetimePrior to 2018-01-12: CERT: Unspecified Relationship
ISO/IEC TR 24772:2013Dangling References to Stack Frames [DCM]Prior to 2018-01-12: CERT: Unspecified Relationship
ISO/IEC TS 17961
Escaping of the address of an automatic object [addrescape]

ISO/IEC PDTR 24772 "DCM Dangling references to stack frames"

MISRA Rule 8.6

Prior to 2018-01-12: CERT: Unspecified Relationship
MISRA C:2012Rule 18.6 (required)Prior to 2018-01-12: CERT: Unspecified Relationship

CERT-CWE Mapping Notes

Key here for mapping notes

CWE-562 and DCL30-C

DCL30-C = Union( CWE-562, list) where list =


  • Assigning a stack pointer to an argument (thereby letting it outlive the current function


Bibliography

[Coverity 2007]
[ISO/IEC 9899:2024]6.2.4, "Storage Durations of Objects"


...

Image Modified Image Modified Image Modified