Function parse_dump_config

addons/y2038.py:214–299

Parse Y2038-related flags from cppcheck dump file configuration name. This function analyzes the cppcheck dump file configuration name (which contains preprocessor definitions extracted by cppcheck from project files like compile_commands.json) to extract Y2038-related definit

(config_name)

def parse_dump_config(config_name):
    """
    Parse Y2038-related flags from cppcheck dump file configuration name.
    
    This function analyzes the cppcheck dump file configuration name (which contains 
    preprocessor definitions extracted by cppcheck from project files like compile_commands.json)
    to extract Y2038-related definitions. It looks for _TIME_BITS, _USE_TIME_BITS64, and 
    _FILE_OFFSET_BITS definitions and validates their values.

    Args:
        config_name (str): The cppcheck configuration name from dump file
                          (e.g., "_TIME_BITS=64;_FILE_OFFSET_BITS=64")

    Returns:
        dict: Dictionary containing Y2038-related flag information with keys:
            - 'time_bits_defined' (bool): Whether _TIME_BITS is defined
            - 'time_bits_value' (int|None): Value of _TIME_BITS (None if not defined)
            - 'use_time_bits64_defined' (bool): Whether _USE_TIME_BITS64 is defined
            - 'file_offset_bits_defined' (bool): Whether _FILE_OFFSET_BITS is defined
            - 'file_offset_bits_value' (int|None): Value of _FILE_OFFSET_BITS (None if not defined)

    Example:
        >>> parse_dump_config("_TIME_BITS=64;_FILE_OFFSET_BITS=64")
        {
            'time_bits_defined': True,
            'time_bits_value': 64,
            'use_time_bits64_defined': False,
            'file_offset_bits_defined': True,
            'file_offset_bits_value': 64
        }
    """
    result = {
        'time_bits_defined': False,
        'time_bits_value': None,
        'use_time_bits64_defined': False,
        'file_offset_bits_defined': False,
        'file_offset_bits_value': None
    }

    if not config_name:
        return result

    try:
        # Check for _TIME_BITS=64 (correct value)
        if re_flag_time_bits_64.search(config_name):
            result['time_bits_defined'] = True
            result['time_bits_value'] = Y2038_SAFE_TIME_BITS
        else:
            # Check for _TIME_BITS=other_value
            match = re_flag_time_bits.search(config_name)
            if match:
                result['time_bits_defined'] = True
                try:
                    result['time_bits_value'] = int(match.group(1))
                except (ValueError, IndexError):
                    # Malformed _TIME_BITS value, treat as undefined
                    result['time_bits_defined'] = False
                    result['time_bits_value'] = None