API: clearly state that os_index isn't unique while logical_index is