NPD.GEN.MUST
Assigned null-pointer constant value is dereferenced
An attempt to access data using a null pointer causes a runtime error. When a program dereferences a pointer that is expected to be valid but turns out to be null, a null pointer dereference occurs. Null-pointer dereference defects often occur due to ineffective error handling or race conditions, and typically cause abnormal program termination. Before a pointer is dereferenced in C/C++ code, it must be checked to confirm that it is not equal to null.
The NPD checkers look for instances in which a null or possibly null pointer is dereferenced.
The NPD.GEN.MUST checker flags situations in which a pointer that's been assigned a null constant value is subsequently dereferenced explicitly or passed to a function that dereferences it without checking it for null.
Vulnerability and risk
Null-pointer dereferences usually result in the failure of the process. These issues typically occur due to ineffective exception handling.
Mitigation and prevention
To avoid this vulnerability:
- Check for a null value in the results of all functions that return values
- Make sure all external inputs are validated
- Explicitly initialize variables
- Make sure that unusual exceptions are handled correctly
Vulnerable code example
void xstrcpy(char *dst, char *src) {
if (!src) return;
dst[0] = src[0];
}
char global_buf[256];
void npd_gen_must(int flag) {
char *p = global_buf;
if (flag) p = 0; // NULL is assigned to p
xstrcpy(p, "Hello");
}
Klocwork flags a defect in this example, because constant NULL is assigned to 'p' if condition 'flag' is true and then dereferenced through a call to function xstrcpy. This vulnerability can produce unexpected and unintended results.
Fixed code example
void xstrcpy(char *dst, char *src) {
if (!src) return;
if (!dst) return;
dst[0] = src[0];
}
char global_buf[256];
void npd_gen_must(int flag) {
char *p = global_buf;
if (flag) p = 0;
xstrcpy(p, "Hello");
}
In the fixed code, *dst is checked for null at line 3.
Related checkers
Security training
Application security training materials provided by Secure Code Warrior.
Extension
This checker can be extended through the Klocwork knowledge base. See Tuning C/C++ analysis for more information.