.. SPDX-License-Identifier: GPL-2.0

.. _tw_volatile_considered_harmful:

.. include:: ../disclaimer-zh_TW.rst

:Original: :ref:`Documentation/process/volatile-considered-harmful.rst
           <volatile_considered_harmful>`

如果想評論或更新本文的內容,請直接聯繫原文檔的維護者。如果你使用英文
交流有困難的話,也可以向中文版維護者求助。如果本翻譯更新不及時或者翻
譯存在問題,請聯繫中文版維護者::

        英文版維護者: Jonathan Corbet <corbet@lwn.net>
        中文版維護者: 伍鵬  Bryan Wu <bryan.wu@analog.com>
        中文版翻譯者: 伍鵬  Bryan Wu <bryan.wu@analog.com>
        中文版校譯者: 張漢輝  Eugene Teo <eugeneteo@kernel.sg>
                       楊瑞  Dave Young <hidave.darkstar@gmail.com>
                       時奎亮 Alex Shi <alex.shi@linux.alibaba.com>
                       胡皓文 Hu Haowen <src.res.211@gmail.com>

爲什麼不應該使用「volatile」類型
================================

C程式設計師通常認爲volatile表示某個變量可以在當前執行的線程之外被改變;因此,在內核
中用到共享數據結構時,常常會有C程式設計師喜歡使用volatile這類變量。換句話說,他們經
常會把volatile類型看成某種簡易的原子變量,當然它們不是。在內核中使用volatile幾
乎總是錯誤的;本文檔將解釋爲什麼這樣。

理解volatile的關鍵是知道它的目的是用來消除優化,實際上很少有人真正需要這樣的應
用。在內核中,程式設計師必須防止意外的並發訪問破壞共享的數據結構,這其實是一個完全
不同的任務。用來防止意外並發訪問的保護措施,可以更加高效的避免大多數優化相關的
問題。

像volatile一樣,內核提供了很多原語來保證並發訪問時的數據安全(自旋鎖, 互斥量,內
存屏障等等),同樣可以防止意外的優化。如果可以正確使用這些內核原語,那麼就沒有
必要再使用volatile。如果仍然必須使用volatile,那麼幾乎可以肯定在代碼的某處有一
個bug。在正確設計的內核代碼中,volatile能帶來的僅僅是使事情變慢。

思考一下這段典型的內核代碼::

    spin_lock(&the_lock);
    do_something_on(&shared_data);
    do_something_else_with(&shared_data);
    spin_unlock(&the_lock);

如果所有的代碼都遵循加鎖規則,當持有the_lock的時候,不可能意外的改變shared_data的
值。任何可能訪問該數據的其他代碼都會在這個鎖上等待。自旋鎖原語跟內存屏障一樣—— 它
們顯式的用來書寫成這樣 —— 意味著數據訪問不會跨越它們而被優化。所以本來編譯器認爲
它知道在shared_data裡面將有什麼,但是因爲spin_lock()調用跟內存屏障一樣,會強制編
譯器忘記它所知道的一切。那麼在訪問這些數據時不會有優化的問題。

如果shared_data被聲名爲volatile,鎖操作將仍然是必須的。就算我們知道沒有其他人正在
使用它,編譯器也將被阻止優化對臨界區內shared_data的訪問。在鎖有效的同時,
shared_data不是volatile的。在處理共享數據的時候,適當的鎖操作可以不再需要
volatile —— 並且是有潛在危害的。

volatile的存儲類型最初是爲那些內存映射的I/O寄存器而定義。在內核里,寄存器訪問也應
該被鎖保護,但是人們也不希望編譯器「優化」臨界區內的寄存器訪問。內核里I/O的內存訪問
是通過訪問函數完成的;不贊成通過指針對I/O內存的直接訪問,並且不是在所有體系架構上
都能工作。那些訪問函數正是爲了防止意外優化而寫的,因此,再說一次,volatile類型不
是必需的。

另一種引起用戶可能使用volatile的情況是當處理器正忙著等待一個變量的值。正確執行一
個忙等待的方法是::

    while (my_variable != what_i_want)
        cpu_relax();

cpu_relax()調用會降低CPU的能量消耗或者讓位於超線程雙處理器;它也作爲內存屏障一樣出
現,所以,再一次,volatile不是必需的。當然,忙等待一開始就是一種反常規的做法。

在內核中,一些稀少的情況下volatile仍然是有意義的:

  - 在一些體系架構的系統上,允許直接的I/0內存訪問,那麼前面提到的訪問函數可以使用
    volatile。基本上,每一個訪問函數調用它自己都是一個小的臨界區域並且保證了按照
    程式設計師期望的那樣發生訪問操作。

  - 某些會改變內存的內聯彙編代碼雖然沒有什麼其他明顯的附作用,但是有被GCC刪除的可
    能性。在彙編聲明中加上volatile關鍵字可以防止這種刪除操作。

  - Jiffies變量是一種特殊情況,雖然每次引用它的時候都可以有不同的值,但讀jiffies
    變量時不需要任何特殊的加鎖保護。所以jiffies變量可以使用volatile,但是不贊成
    其他跟jiffies相同類型變量使用volatile。Jiffies被認爲是一種「愚蠢的遺留物"
    (Linus的話)因爲解決這個問題比保持現狀要麻煩的多。

  - 由於某些I/0設備可能會修改連續一致的內存,所以有時,指向連續一致內存的數據結構
    的指針需要正確的使用volatile。網絡適配器使用的環狀緩存區正是這類情形的一個例
    子,其中適配器用改變指針來表示哪些描述符已經處理過了。

對於大多代碼,上述幾種可以使用volatile的情況都不適用。所以,使用volatile是一種
bug並且需要對這樣的代碼額外仔細檢查。那些試圖使用volatile的開發人員需要退一步想想
他們真正想實現的是什麼。

非常歡迎刪除volatile變量的補丁 - 只要證明這些補丁完整的考慮了並發問題。

注釋
----

[1] https://lwn.net/Articles/233481/
[2] https://lwn.net/Articles/233482/

致謝
----

最初由Randy Dunlap推動並作初步研究
由Jonathan Corbet撰寫
參考Satyam Sharma,Johannes Stezenbach,Jesper Juhl,Heikki Orsila,
H. Peter Anvin,Philipp Hahn和Stefan Richter的意見改善了本檔。