getsockopt() - Unix、Linux系統呼叫

名稱

概要

int getsockopt(int s, int level, int optname, void *optval, socklen_t *optlen);

int setsockopt(int s, int level, int optname, const void *optval, socklen_t optlen);

描述

操作套接字選項時，必須指定選項所在的層級和選項的名稱。要操作套接字層級的選項，level 指定為SOL_SOCKET。要操作任何其他層級的選項，則提供控制該選項的相應協議的協議號。例如，要指示選項應由TCP協議解釋，level應設定為TCP的協議號；參見getprotoent(3)。

引數optval和optlen用於訪問setsockopt()的選項值。對於getsockopt()，它們標識一個緩衝區，其中將返回請求的選項值。對於getsockopt()，optlen是一個值-結果引數，最初包含optval指向的緩衝區的大小，並在返回時修改以指示返回的值的實際大小。如果不需要提供或返回選項值，optval可以為NULL。

Optname和任何指定的選項都將未經解釋地傳遞給相應的協議模組進行解釋。包含檔案<sys/socket.h>包含套接字層選項的定義，如下所述。其他協議層級的選項格式和名稱各不相同；請查閱手冊第4節中的相應條目。

大多數套接字層選項都使用int引數作為optval。對於setsockopt()，引數應為非零值以啟用布林選項，如果要停用選項，則為零。

有關可用套接字選項的說明，請參見socket(7)和相應的協議手冊頁。

返回值

錯誤

符合標準

注意

缺陷

參見

• ioctl (2)

• socket (2)