sub-rotina gethostname

Editar online

Propósito

Recebe o nome do apresentador local.

Biblioteca

Biblioteca C Padrão (libc.a)

Sintaxe

#include <unistd.h>
  
int gethostname ( Name,  NameLength)
char *Name;
size_t NameLength;

Descrição

A subroutine gethostname recupera o nome de host padrão do host local. Se o espaço em excesso for fornecido, o parâmetro Nome retornado será nulo-finalizado. Se espaço insuficiente for fornecido, o nome retornado será truncado para caber no espaço determinado. Os nomes do host do sistema são limitados a 256 caracteres.

O subroutine gethostname permite um processo de chamada para determinar o nome do host interno para uma máquina em uma rede.

Todos os aplicativos contendo a subroutine gethostname devem ser compilados com o macro _BSD configurado para um valor específico. Os valores aceitáveis são 43 e 44. Além disso, todos os aplicativos de soquete devem incluir a biblioteca BSD libbsd.a ..

Parâmetros

Item Descrição
Nome Especifica o endereço de uma matriz de bytes onde o nome do host deve ser armazenado.
NameLength Especifica o comprimento da matriz Nome .

Valores De Retorno

Após a conclusão bem-sucedida, o sistema devolve um valor de 0.

Se a subroutine gethostname não for bem sucedida, o manipulador de subroutine executa as seguintes funções:

  • Retorna um valor de -1 para o programa de chamada.
  • Move um código de erro, indicando o erro específico, na variável global errno .

Códigos De Erro

A subroutine gethostname não é bem-sucedida se o seguinte for verdadeiro:

Erro Descrição
EFAULT O parâmetro Name ou NameLength fornece um endereço inválido.