---
title: accept
description: "**accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen)**"
url: https://www.hikunpeng.com/document/detail/zh/knet/api/docs/zh/api/posix_apis/accept.md
sourcePath: /source/zh/knet/api/docs/zh/api/posix_apis/accept.md
indexId: 423d89b0b714aeb1019e13dc648ca50666e134a53a817e639a7590d4b911628452
---
# accept

## 接口名称

**accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen)**

## 接口描述

在侦听socket接收新的连接。

## 参数说明

|参数|说明|备注|
|--|--|--|
|sockfd|通信节点描述符|必须是侦听socket。|
|*addr|通信对端地址|可以为空指针。会填写为对端socket的地址，长度根据协议地址类型而定，参考socket接口支持的协议。|
|*addrlen|地址长度|可以为空指针。必须设置为可以包含地址结构体的长度，函数返回时设置为实际的长度。|

## 返回值

类型：int

- 非负数：接收的新socket，表示成功
- -1：表示失败，并设置errno以指示错误类型

## 错误码

|错误码|描述|
|--|--|
|EAGAIN or EWOULDBLOCK|套接字标记为非阻塞，并且不存在要接收的连接。|
|EINTR|被信号中断。|
|EINVAL|入参addrlen的值小于对应地址族长度或大于INT_MAX，或者未侦听，导致套接字不能建立连接。|
|EOPNOTSUPP|引用的套接字不是TCP类型。|
|EACCES|进程没有适当的权限。|
|ENOBUFS|系统中可用资源不足。|
|ENOMEM|内存申请失败。|
|EMFILE|进程的file数量超过max_tcpcb。|
|ELIBBAD|加载系统符号失败。|
|EFAULT|入参addrlen为空且addr不为空。|
|EINVAL|套接字存在，但是套接字对应的数据结构存在异常。|
|EPERM|信号退出流程中，不允许调用该函数接口。|
|EINVAL|共线程部署模式时，sockfd的worker id和当前线程的worker id不一致，即socket跨worker线程调用。|