Skip to content
Syscall BSD#105

svc · unix #105

setsockopt

Définit une option associée à une socket à un niveau de protocole donné.

Prototype

int setsockopt(int s, int level, int name, caddr_t val, socklen_t valsize);

Retour: int

Arguments

NameTypeDirDescription
sint-
levelint-
nameint-
valcaddr_t-
valsizesocklen_t-

Historique des versions

XNU tagmacOS#
xnu-1456.1.26macOS 10.6 Snow Leopard105
xnu-1699.24.8macOS 10.7 Lion105
xnu-2050.18.24macOS 10.8 Mountain Lion105
xnu-2422.115.4macOS 10.9 Mavericks105
xnu-2782.40.9macOS 10.10 Yosemite105
xnu-3247.1.106macOS 10.11 El Capitan105
xnu-3789.1.32macOS 10.12 Sierra105
xnu-4570.1.46macOS 10.13 High Sierra105
xnu-4903.221.2macOS 10.14 Mojave105
xnu-6153.11.26macOS 10.15 Catalina105
xnu-7195.50.7.100.1macOS 11.0 Big Sur105
xnu-8019.41.5macOS 12.0 Monterey105
xnu-8792.41.9macOS 13.0 Ventura105
xnu-10002.1.13macOS 14.0 Sonoma105
xnu-11215.1.10macOS 15.0 Sequoia105
xnu-11417.101.15macOS 15.4 Sequoia105
xnu-12377.1.9macOS 26.0 Tahoe105
xnu-10002.41.9105
xnu-10002.61.3105
xnu-10002.81.5105
xnu-10063.101.15105
xnu-10063.121.3105
xnu-10063.141.1105
xnu-11215.41.3105
xnu-11215.61.5105
xnu-11215.81.4105
xnu-11417.121.6105
xnu-11417.140.69105
xnu-12377.101.15105
xnu-12377.41.6105
xnu-12377.61.12105
xnu-12377.81.4105
xnu-1486.2.11105
xnu-1504.15.3105
xnu-1504.3.12105
xnu-1504.7.4105
xnu-1504.9.17105
xnu-1504.9.26105
xnu-1504.9.37105
xnu-1699.22.73105
xnu-1699.22.81105
xnu-1699.24.23105
xnu-1699.26.8105
xnu-1699.32.7105
xnu-2050.22.13105
xnu-2050.24.15105
xnu-2050.48.11105
xnu-2050.7.9105
xnu-2050.9.2105
xnu-2422.1.72105
xnu-2422.100.13105
xnu-2422.110.17105
xnu-2422.90.20105
xnu-2782.1.97105
xnu-2782.10.72105
xnu-2782.20.48105
xnu-2782.30.5105
xnu-3247.10.11105
xnu-3248.20.55105
xnu-3248.30.4105
xnu-3248.40.184105
xnu-3248.50.21105
xnu-3248.60.10105
xnu-3789.21.4105
xnu-3789.31.2105
xnu-3789.41.3105
xnu-3789.51.2105
xnu-3789.60.24105
xnu-3789.70.16105
xnu-4570.20.62105
xnu-4570.31.3105
xnu-4570.41.2105
xnu-4570.51.1105
xnu-4570.61.1105
xnu-4570.71.2105
xnu-4903.231.4105
xnu-4903.241.1105
xnu-4903.270.47105
xnu-6153.101.6105
xnu-6153.121.1105
xnu-6153.141.1105
xnu-6153.41.3105
xnu-6153.61.1105
xnu-6153.81.5105
xnu-7195.101.1105
xnu-7195.121.3105
xnu-7195.141.2105
xnu-7195.60.75105
xnu-7195.81.3105
xnu-8019.61.5105
xnu-8019.80.24105
xnu-8020.101.4105
xnu-8020.121.3105
xnu-8020.140.41105
xnu-8792.61.2105
xnu-8792.81.2105
xnu-8796.101.5105
xnu-8796.121.2105
xnu-8796.141.3105

Exemples

Bind a connect() to interface en0

#include <net/if.h>
unsigned int ifidx = if_nametoindex("en0");
setsockopt(fd, IPPROTO_IP, IP_BOUND_IF, &ifidx, sizeof(ifidx));

Notes

Au-delà des POSIX SO_REUSEADDR/SO_KEEPALIVE/SO_LINGER, macOS expose des options critiques pour le réseau moderne : SO_NOSIGPIPE, SO_NOWAKEFROMSLEEP, SO_RECV_ANYIF, IP_BOUND_IF (lier à un index d'interface spécifique — utilisé par les VPN et le routage par app), TCP_FASTOPEN (TFO), TCP_ENABLE_ECN, TCP_NOTSENT_LOWAT (utilisée par URLSession pour la régulation adaptative), et les options SOL_NECP attach/detach qui lient une socket à un chemin Network.framework. Certaines options nécessitent des entitlements : SO_RECV_ANYIF, SO_DELEGATED, IPPROTO_IP/IP_BOUND_IF sur les interfaces protégées.

Détection

Aucune couverture ES. Observer setsockopt à grande échelle implique généralement un kext ou une extension DriverKit accrochée à la KPI de filtre socket (sflt_register), désormais restreinte au code signé Apple sur Apple Silicon.

API associées

getsockoptsocketbindconnectnecp_client_action