Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   12896 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

sethostname(2)							sethostname(2)

NAME
       sethostname - Set the name of the current host

SYNOPSIS
       int sethostname(
	       char *name,
	       int name_len );

PARAMETERS
       Points  to  an array of bytes where the host name is stored.  Specifies
       the length of the array pointed to by the name parameter.

DESCRIPTION
       The sethostname() function allows a  calling  process  with  root  user
       authority to set the internal host name of a machine on a network.

       System  host  names  are	 limited  to  MAXHOSTNAMELEN as defined in the
       /usr/include/sys/param.h file.

       The sethostid() function fails if the calling process does not have the
       superuser privilege.

RETURN VALUES
       Upon successful completion, the system returns a value of 0 (zero).  If
       the sethostname() function fails, -1 is returned and errno  is  set  to
       indicate the error.

ERRORS
       If  the	sethostname()  function	 fails, errno may be set to one of the
       following values: The name parameter or the name_len parameter gives an
       address that is not valid.  The calling process does not have appropri‐
       ate privilege.

SEE ALSO
       Functions: gethostid(2), sethostid(2), gethostname(2)

								sethostname(2)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome