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

## 接口名称

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

## 接口描述

获取socket连接地址信息。

## 参数说明

|参数|说明|备注|
|--|--|--|
|sockfd|通信节点描述符|传入socket描述符。|
|*addr|通信地址|函数正常返回时填写地址信息，即获取到的地址信息存储在该参数中。|
|*addrlen|地址长度|输入的地址长度必须足够存放地址信息。函数正常返回时修改为实际的地址长度。|

## 返回值

类型：int

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

## 错误码

|错误码|描述|
|--|--|
|EINVAL|入参addrlen不是地址族的有效长度，入参addrlen大于INT_MAX，或套接字已被shutdown。|
|EFAULT|套接字结构地址在用户的地址空间之外。|
|ELIBBAD|系统符号加载失败。|
|EINVAL|套接字存在，但是套接字对应的数据结构存在异常。|
|EINVAL|共线程部署模式时，sockfd的worker id和当前线程的worker id不一致，即socket跨worker线程调用。|