OPENSSL_API_COMPAT
名稱
openssl_user_macros、OPENSSL_API_COMPAT、OPENSSL_NO_DEPRECATED - 使用者定義的巨集
說明
使用者定義的巨集允許程式設計師控制 OpenSSL 標頭公開的特定面向。
注意:若要生效,使用者定義的巨集必須在包含任何依賴它的標頭檔案之前定義,可以在編譯指令 (cc -DMACRO=value
) 中定義,或在包含任何標頭之前在原始碼中定義巨集。
當宣告依賴使用者定義的巨集時,其他手冊頁面可能會參照此頁面。
巨集
- OPENSSL_API_COMPAT
-
值是版本號碼,採用下列兩種形式之一
0xMNNFF000L
-
這是所有 1.1.x 以下版本支援的形式,其中
M
代表主版本號碼,NN
代表次要版本號碼,FF
代表修正版本號碼,為十六進位數字。對於版本 1.1.0,為0x10100000L
。可以提供任何版本號碼,但這些號碼是目前已知的重大棄用點,因此最具意義
0x00908000L
(版本 0.9.8)0x10000000L
(版本 1.0.0)0x10100000L
(版本 1.1.0)
為方便起見,只要可行,也會接受較高的數字。例如,
0x60000000L
會按預期運作。不過,建議改用第二種形式 mmnnpp
-
此形式是使用下列公式計算的簡單十進位數字
主版本號碼 * 10000 + 次要版本號碼 * 100 + 修補程式
其中主版本號碼、次要版本號碼和修補程式是版本號碼中所需的主版本號碼、次要版本號碼和修補程式元件。例如
- 30000 對應到版本 3.0.0
- 10002 對應到版本 1.0.2
- 420101 對應到版本 42.1.1
如果未定義 OPENSSL_API_COMPAT,則會使用此預設值:
30300
- OPENSSL_NO_DEPRECATED
-
如果定義此巨集,則在所有 OpenSSL 版本中,包括 OPENSSL_API_COMPAT (或未定義 OPENSSL_API_COMPAT 時,上面給出的預設值) 所指定的版本,所有已棄用的公開符號都會隱藏起來。
版權
版權所有 2018-2021 OpenSSL 專案作者。保留所有權利。
根據 Apache 授權條款 2.0(「授權條款」)授權。您只能在遵守授權條款的情況下使用此檔案。您可以在原始程式碼的 LICENSE 檔案中取得一份副本,或至 https://www.openssl.org/source/license.html 取得。