getsockname(2)

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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 (debian-l10n-portuguese@lists.debian.org).