---
title: setsockopt
description: "**setsockopt(int sockfd, int level, int optname, const void *optval, socklen_t optlen)**"
url: https://www.hikunpeng.com/document/detail/zh/knet/api/docs/zh/api/posix_apis/setsockopt.md
sourcePath: /source/zh/knet/api/docs/zh/api/posix_apis/setsockopt.md
indexId: 51ab78f3ca20549055f4d3c31ad60c25e27957cdde0f2afdf15d2daad7089d4956
---
# setsockopt

## 接口名称

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

## 接口描述

设置socket选项值。

## 参数说明

|参数|说明|备注|
|--|--|--|
|sockfd|通信节点描述符|传入socket描述符。|
|level|选项级别|支持SOL_SOCKET、IPPROTO_IP、IPPROTO_TCP。|
|optname|选项名称|SO_REUSEADDR：地址重用，0表示关闭；非0表示开启，默认关闭。SO_REUSEPORT：端口重用，0表示关闭；非0表示开启，默认关闭。SO_KEEPALIVE：保活选项，0表示关闭；非0表示开启，默认关闭。SO_LINGER：linger选项，默认关闭 。SO_SNDBUF：设置发送缓存高水位，默认TCP 8k、UDP 9k。设置值必须比默认值大，否则返回错误。SO_RCVBUF：设置接收缓存高水位，默认TCP 8k、UDP 40k。设置值必须比默认值大，否则返回错误。SO_SNDTIMEO：阻塞模式发送超时时间 。SO_RCVTIMEO：阻塞模式接收等待时间。SO_PRIORITY：设置套接字发送数据包的优先级，规格为[0，6]。SO_RCVLOWAT：设置recv()返回所需的最小字节数（低水位标记）。TCP_NODELAY：设置是否禁止TCP的Nagle算法，默认开启Nagle算法。TCP_KEEPIDLE：在指定的空闲时间后启动保活探测，单位秒，规格为[1, 32767] 。TCP_KEEPINTVL：设置保活探测的时间间隔，单位秒，规格为[1, 32767] 。TCP_KEEPCNT：设置保活探测的次数，规格为[1, 127] 。TCP_CORK：设置cork选项。1表示开启，0表示关闭，默认关闭。TCP_DEFER_ACCEPT：子socket收到数据再上报侦听socket建链完成，单位秒。TCP_MAXSEG:设置TCP最大报文段，缺省IPV4 1460，范围[88, 32767]。TCP_USER_TIMEOUT:设置用户超时时间，单位毫秒。IP_TOS：设置TOS。|
|*optval|选项值|非空指针。|
|optlen|选项长度|长度随optval的类型而定。|

## 返回值

类型：int

- 0：表示成功
- -1：表示失败，并设置errno以指示错误类型

## 错误码

|错误码|描述|
|--|--|
|EFAULT|入参optval为空指针。|
|ENOPROTOOPT|协议不支持该选项。|
|EINVAL|指定的选项在指定的套接字级别无效。入参optlen的值大于INT_MAX，或者入参optlen的值小于对应长度。|
|EDOM|发送和接收超时值太大，无法放入套接字结构中的超时值字段。|
|EISCONN|套接字已经连接，且在套接字处于连接状态时不能设置指定的选项。|
|ELIBBAD|系统符号加载失败。|
|EINVAL|套接字存在，但是套接字对应的数据结构存在异常。|
|EINVAL|共线程部署模式时，sockfd的worker id和当前线程的worker id不一致，即socket跨worker线程调用。|