Release of Invalid Pointer or Reference

The product attempts to return a memory resource to the system, but it calls the wrong release function or calls the appropriate release function incorrectly.


Description

This weakness can take several forms, such as:

The memory was allocated, explicitly or implicitly, via one memory management method and deallocated using a different, non-compatible function (CWE-762).

The function calls or memory management routines chosen are appropriate, however they are used incorrectly, such as in CWE-761.

Demonstrations

The following examples help to illustrate the nature of this weakness and describe methods or techniques which can be used to mitigate the risk.

Note that the examples here are by no means exhaustive and any given weakness may have many subtle varieties, each of which may require different detection methods or runtime controls.

Example One

This code attempts to tokenize a string and place it into an array using the strsep function, which inserts a \0 byte in place of whitespace or a tab character. After finishing the loop, each string in the AP array points to a location within the input string.

char **ap, *argv[10], *inputstring;
for (ap = argv; (*ap = strsep(&inputstring, " \t")) != NULL;)

  if (**ap != '\0')
    if (++ap >= &argv[10])
      break;




/.../
free(ap[4]);

Since strsep is not allocating any new memory, freeing an element in the middle of the array is equivalent to free a pointer in the middle of inputstring.

Example Two

This example allocates a BarObj object using the new operator in C++, however, the programmer then deallocates the object using free(), which may lead to unexpected behavior.

void foo(){

  BarObj *ptr = new BarObj()
  /* do some work with ptr here */

  ...

  free(ptr);

}

Instead, the programmer should have either created the object with one of the malloc family functions, or else deleted the object with the delete operator.

void foo(){

  BarObj *ptr = new BarObj()
  /* do some work with ptr here */

  ...

  delete ptr;

}

Example Three

In this example, the programmer dynamically allocates a buffer to hold a string and then searches for a specific character. After completing the search, the programmer attempts to release the allocated memory and return SUCCESS or FAILURE to the caller. Note: for simplification, this example uses a hard-coded "Search Me!" string and a constant string length of 20.

#define SUCCESS (1)
#define FAILURE (0)

int contains_char(char c){

  char *str;
  str = (char*)malloc(20*sizeof(char));
  strcpy(str, "Search Me!");
  while( *str != NULL){

    if( *str == c ){


      /* matched char, free string and return success */
      free(str);
      return SUCCESS;

    }
    /* didn't match yet, increment pointer and try next char */

    str = str + 1;

  }
  /* we did not match the char in the string, free mem and return failure */

  free(str);
  return FAILURE;

}

However, if the character is not at the beginning of the string, or if it is not in the string at all, then the pointer will not be at the start of the buffer when the programmer frees it.

Instead of freeing the pointer in the middle of the buffer, the programmer can use an indexing pointer to step through the memory or abstract the memory calculations by using array indexing.

#define SUCCESS (1)
#define FAILURE (0)

int cointains_char(char c){

  char *str;
  int i = 0;
  str = (char*)malloc(20*sizeof(char));
  strcpy(str, "Search Me!");
  while( i < strlen(str) ){

    if( str[i] == c ){


      /* matched char, free string and return success */
      free(str);
      return SUCCESS;

    }
    /* didn't match yet, increment pointer and try next char */

    i = i + 1;

  }
  /* we did not match the char in the string, free mem and return failure */

  free(str);
  return FAILURE;

}

Example Four

Consider the following code in the context of a parsing application to extract commands out of user data. The intent is to parse each command and add it to a queue of commands to be executed, discarding each malformed entry.

//hardcode input length for simplicity
char* input = (char*) malloc(40*sizeof(char));
char *tok;
char* sep = " \t";

get_user_input( input );

/* The following loop will parse and process each token in the input string */

tok = strtok( input, sep);
while( NULL != tok ){

  if( isMalformed( tok ) ){


    /* ignore and discard bad data */
    free( tok );

  }
  else{
    add_to_command_queue( tok );
  }
  tok = strtok( NULL, sep));

}

While the above code attempts to free memory associated with bad commands, since the memory was all allocated in one chunk, it must all be freed together.

One way to fix this problem would be to copy the commands into a new memory location before placing them in the queue. Then, after all commands have been processed, the memory can safely be freed.

//hardcode input length for simplicity
char* input = (char*) malloc(40*sizeof(char));
char *tok, *command;
char* sep = " \t";

get_user_input( input );

/* The following loop will parse and process each token in the input string */

tok = strtok( input, sep);
while( NULL != tok ){

  if( !isMalformed( command ) ){


    /* copy and enqueue good data */
    command = (char*) malloc( (strlen(tok) + 1) * sizeof(char) );
    strcpy( command, tok );
    add_to_command_queue( command );

  }
  tok = strtok( NULL, sep));

}

free( input )

See Also

Comprehensive Categorization: Memory Safety

Weaknesses in this category are related to memory safety.

SFP Primary Cluster: Faulty Resource Release

This category identifies Software Fault Patterns (SFPs) within the Faulty Resource Release cluster (SFP37).

SFP Secondary Cluster: Faulty Memory Release

This category identifies Software Fault Patterns (SFPs) within the Faulty Memory Release cluster (SFP12).

Comprehensive CWE Dictionary

This view (slice) covers all the elements in CWE.

Entries with Maintenance Notes

CWE entries in this view have maintenance notes. Maintenance notes are an indicator that an entry might change significantly in future versions. This view was created...

CWE Cross-section

This view contains a selection of weaknesses that represent the variety of weaknesses that are captured in CWE, at a level of abstraction that is likely to be useful t...


Common Weakness Enumeration content on this website is copyright of The MITRE Corporation unless otherwise specified. Use of the Common Weakness Enumeration and the associated references on this website are subject to the Terms of Use as specified by The MITRE Corporation.