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'.

VEJA TAMBÉM

       getdomainname(2), setdomainname(2), uname(2)