...
The C Standard, 6.5.7, paragraph 4 [ISO/IEC 9899:2011], states
...
In almost every case, an attempt to shift by a negative number of bits or by more bits than exist in the operand indicates a logic error. These issues are covered by INT34-C. Do not shift an expression by a negative number of bits or by greater than or equal to the number of bits that exist in the operand.
Noncompliant Code Example
This noncompliant code example performs a left shift, after verifying that the number being shifted is not negative, and the number of bits to shift is valid. The PRECISION()
macro and popcount()
function provide the correct precision for any integer type. (See INT35-C. Use correct integer precisions.) However, because this code does no overflow check, it can result in an unrepresentable value.
...
Compliant Solution
This compliant solution eliminates the possibility of overflow resulting from a left-shift operation:
...
Search for vulnerabilities resulting from the violation of this rule on the CERT website.
Related Guidelines
Key here (explains table format and definitions)
CERT-CWE Mapping Notes
Key here for mapping notes
CWE-20 and INT32-C
See CWE-20 and ERR34-C
CWE-680 and INT32-C
Intersection( INT32-C, MEM35-C) = Ø
Intersection( CWE-680, INT32-C) =
- Signed integer overflows that lead to buffer overflows
CWE-680 - INT32-C =
- Unsigned integer overflows that lead to buffer overflows
INT32-C – CWE-680 =
- Signed integer overflows that do not lead to buffer overflows
CWE-191 and INT32-C
Union( CWE-190, CWE-191) = Union( INT30-C, INT32-C) Intersection( INT30-C, INT32-C) == Ø
Intersection(CWE-191, INT32-C) =
- Underflow of signed integer operation
CWE-191 – INT32-C =
- Underflow of unsigned integer operation
INT32-C – CWE-191 =
- Overflow of signed integer operation
CWE-190 and INT32-C
Union( CWE-190, CWE-191) = Union( INT30-C, INT32-C) Intersection( INT30-C, INT32-C) == Ø
Intersection(CWE-190, INT32-C) =
- Overflow (wraparound) of signed integer operation
CWE-190 – INT32-C =
- Overflow of unsigned integer operation
INT32-C – CWE-190 =
- Underflow of signed integer operation
Bibliography
[Dowd 2006] | Chapter 6, "C Language Issues" ("Arithmetic Boundary Conditions," pp. 211–223) |
[ISO/IEC 9899:2011] | Subclause 6.5.5, "Multiplicative Operators" |
[Seacord 2013b] | Chapter 5, "Integer Security" |
[Viega 2005] | Section 5.2.7, "Integer Overflow" |
[Warren 2002] | Chapter 2, "Basics" |
...