Standard C Library Functions                      gethostname(3C)



NAME
     gethostname, sethostname - get or set name of current host

SYNOPSIS
     #include 

     int gethostname(char *name, int namelen);


     int sethostname(char *name, int namelen);


DESCRIPTION
     The gethostname() function returns the  standard  host  name
     for  the  current  processor,  as previously set by sethost-
     name(). The  namelen argument  specifies  the  size  of  the
     array  pointed  to  by  name.  The  returned  name  is null-
     terminated unless insufficient space is provided.


     The sethostname() function sets the name of the host machine
     to  be  name,  which  has  length namelen. This call is res-
     tricted to the superuser and is normally used only when  the
     system is bootstrapped.


     Host  names  are  limited  to   MAXHOSTNAMELEN   characters,
     currently 256, defined in the  header.

RETURN VALUES
     Upon successful completion, gethostname() and  sethostname()
     return  0.  Otherwise, they return -1 and set errno to indi-
     cate the error.

ERORS
     The gethostname() and sethostname() functions will fail if:

     EFAULT    The name  or  namelen  argument  gave  an  invalid
               address.



     The sethostname() function will fail if:

     EPERM    The {PRIVSYSADMIN} privilege was not asserted  in
              the effective set of the calling process.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:




SunOS 5.11          Last change: 22 Mar 2004                    1






Standard C Library Functions                      gethostname(3C)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     sysinfo(2), uname(2),  gethostid(3C),  attributes(5),  stan-
     dards(5)











































SunOS 5.11          Last change: 22 Mar 2004                    2