sub-rotina sethostid

Editar online

Propósito

Configura o identificador único do host atual.

Biblioteca

Biblioteca C Padrão (libc.a)

Sintaxe

int sethostid ( HostID)
int HostID;

Descrição

A subroutine sethostid permite um processo de chamada com um ID de usuário root para configurar um novo identificador de 32-bit bits para o host atual. A subroutine sethostid possibilita um programa de aplicativos para redefinir o ID do host.

Todos os aplicativos contendo a subroutine sethostid devem ser compilados com o macro conjunto _BSD 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
HostID Especifica o identificador único de 32-bit para o host atual.

Valores De Retorno

Após a conclusão bem-sucedida, a subroutina sethostid retorna um valor de 0.

Se a subroutine sethostid 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 . Para mais explicações sobre a variável errno ver Error Notificam Object Class no Communications Programming Concepts.

Códigos De Erro

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

Erro Descrição
EPERM O processo de chamada não possuia um ID de usuário efetivo de root user.