OpenSSL

加密和 SSL/TLS 工具包

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 取得。