NOME¶

getsockname - obtém o nome de um 'socket'

BIBLIOTECA¶

Biblioteca C Padrão (libc, -lc)

SINOPSE¶

#include <sys/socket.h>

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

DESCRIÇÃO¶

getsockname() devolve o endereço atual ao qual o socket sockfd está vinculado, no buffer apontado por addr. O argumento namelen deve ser inicializado para indicar a quantidade de espaço (em bytes) apontada por addr. No retorno, ele contém o tamanho real do endereço de socket.

O endereço retornado é truncado se o buffer fornecido for pequeno demais; neste caspp, addrlen vai retornar um valor maior que o que foi fornecido para a chamada.

VALOR DE RETORNO¶

Em caso de sucesso, zero é retornado. Em caso de erro, -1 é retornado, e errno é definido para indicar o erro.

ERROS¶

EBADF

O argumento sockfd não é um descritor de arquivo válido.

EFAULT

O argumento addr aponta para memória que não está em uma parte válida do espaço de endereço de processo.

EINVAL

addrlen é inválido (por exemplo, é negativo).

ENOBUFS

Recursos insuficientes no seu sistema para completar a operação.

ENOTSOCK

O descritor de arquivo sockfd não faz referência a um socket.

PADRÕES¶

POSIX.1-2024.

HISTÓRICO¶

POSIX.1-2001, SVr4, 4.2BSD.

VEJA TAMBÉM¶

bind(2), socket(2), getifaddrs(3), ip(7), socket(7), unix(7)

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por André Luiz Fassone <lonely_wolf@ig.com.br>, Ricardo C.O.Freitas <english.quest@best-service.com> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.