OpenSSL

密碼學和 SSL/TLS 工具組

OPENSSL_NO_DEPRECATED

名稱

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_API_COMPAT (或在未定義 OPENSSL_API_COMPAT 時,給定的預設值) 所提供的版本(含)以下的所有 OpenSSL 版本中,所有已不建議使用的公開符號都會被隱藏。

版權所有 2018-2021 The OpenSSL Project Authors。保留所有權利。

根據 Apache 許可證 2.0(「許可證」)取得授權。您只能在遵守許可證的情況下使用此檔案。您可以在原始程式碼散佈中的 LICENSE 檔案中取得一份副本,或在 https://www.openssl.org/source/license.html 取得。