Skip to content
  • Stefan Hajnoczi's avatar
    system/cpus: rename qemu_mutex_lock_iothread() to bql_lock() · 195801d7
    Stefan Hajnoczi authored
    
    
    The Big QEMU Lock (BQL) has many names and they are confusing. The
    actual QemuMutex variable is called qemu_global_mutex but it's commonly
    referred to as the BQL in discussions and some code comments. The
    locking APIs, however, are called qemu_mutex_lock_iothread() and
    qemu_mutex_unlock_iothread().
    
    The "iothread" name is historic and comes from when the main thread was
    split into into KVM vcpu threads and the "iothread" (now called the main
    loop thread). I have contributed to the confusion myself by introducing
    a separate --object iothread, a separate concept unrelated to the BQL.
    
    The "iothread" name is no longer appropriate for the BQL. Rename the
    locking APIs to:
    - void bql_lock(void)
    - void bql_unlock(void)
    - bool bql_locked(void)
    
    There are more APIs with "iothread" in their names. Subsequent patches
    will rename them. There are also comments and documentation that will be
    updated in later patches.
    
    Signed-off-by: default avatarStefan Hajnoczi <stefanha@...>
    195801d7