NOME
gethostname, sethostname − obtém/seleciona o nome da máquina
SINOPSE
#include <unistd.h>
int
gethostname(char *name, size_t
len);
int sethostname(const char *name, size_t
len);
DESCRIÇÃO
Estas funções são usadas para acessar ou alterar o nome da máquina do processador atual.
VALORES RETORNADOS
Em caso de successo, zero é retornado. Caso contrário, −1 é retornado, e errno é selecionado adequadamente.
ERROS
|
EINVAL |
len é negativo ou, para sethostname, len é maior que o tamanho permitido, ou, para gethostname em Linux/i386, len é menor que o tamanho atual. (Neste último caso glibc 2.1 usa ENAMETOOLONG.) | ||
|
EPERM |
Para sethostname, o solicitante não é o superusuário. | ||
|
EFAULT |
name é um endereço inválido. |
DE ACORDO COM
SVr4, 4.4BSD (esta função apareceu primeiramente no BSD 4.2). POSIX.1 não define estas funções, mas ISO/IEC 9945-1:1990 menciona elas no B.4.4.1.
PROBLEMAS
De acordo com o SUSv2, gethostname devem retornar os bytes len (um hostname cortado, terminação nula ou não) quando o hostname é comprido. Linux/Alpha (os quais tem uma chamada de sistema gethostname) cumpre com este requerimento, mas a libc e glibc no Linux/i386 somente retornan um erro neste caso.
NOTAS
As definições de sucesso variam. SUSv2 define gethostname() como ’retorno hostname possivelmente cortado’, e tendo um pequeno len não causa retorno de erro. Certamente deve ser possível estar certo que um tenha obtido o hostname completo, e para isto terminar SUSv2 guarante que ’Host names são limitados para 255 bytes’.