• Kumar Kartikeya Dwivedi's avatar
    bpf: Add comments for map BTF matching requirement for bpf_list_head · c22dfdd2
    Kumar Kartikeya Dwivedi authored
    The old behavior of bpf_map_meta_equal was that it compared timer_off
    to be equal (but not spin_lock_off, because that was not allowed), and
    did memcmp of kptr_off_tab.
    
    Now, we memcmp the btf_record of two bpf_map structs, which has all
    fields.
    
    We preserve backwards compat as we kzalloc the array, so if only spin
    lock and timer exist in map, we only compare offset while the rest of
    unused members in the btf_field struct are zeroed out.
    
    In case of kptr, btf and everything else is of vmlinux or module, so as
    long type is same it will match, since kernel btf, module, dtor pointer
    will be same across maps.
    
    Now with list_head in the mix, things are a bit complicated. We
    implicitly add a requirement that both BTFs are same, because struct
    btf_field_list_head has btf and value_rec members.
    
    We obviously shouldn't force BTFs to be equal by default, as that breaks
    backwards compatibility.
    
    Currently it is only implicitly required due to list_head matching
    struct btf and value_rec member. value_rec points back into a btf_record
    stashed in the map BTF (btf member of btf_field_list_head). So that
    pointer and btf member has to match exactly.
    
    Document all these subtle details so that things don't break in the
    future when touching this code.
    Signed-off-by: default avatarKumar Kartikeya Dwivedi <memxor@gmail.com>
    Link: https://lore.kernel.org/r/20221118015614.2013203-19-memxor@gmail.comSigned-off-by: default avatarAlexei Starovoitov <ast@kernel.org>
    c22dfdd2
map_in_map.c 3.85 KB