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   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

sethostname(2)							sethostname(2)

NAME
       sethostname() - set name of current host system

SYNOPSIS
DESCRIPTION
       The  system call sets the name of the current system to name, which has
       a length of namelen characters.	At system boot time is	normally  exe‐
       cuted  by  the command (see hostname(1)) in the script.	Host names are
       limited to characters, as defined in

   Security Restrictions
       Prior to ContainmentExt B.11.31.03, the actions	associated  with  this
       system  call  require  the  privilege If ContainmentExt B.11.31.03 or a
       later version of HP-UX Containment product is installed on the  system,
       either  the privilege or the privilege is required.  Processes owned by
       the superuser have this privilege.  Processes owned by other users  may
       have this privilege, depending on system configuration.

       See  privileges(5) for more information about privileged access on sys‐
       tems that support fine-grained privileges.

RETURN VALUE
       returns the following values:

	      Successful completion.
	      Failure.
		     is set to indicate the error.

ERRORS
       If fails, is set to one of the following values.

	      name	     points  to	 an  illegal  address.	 The  reliable
			     detection	of this error is implementation depen‐
			     dent.

	      The user does not have appropriate privileges.

WARNINGS
       Setting a hostname of more than 64 bytes with is possible only with the
       appropriate  configuration  options  enabled (see nodehostnamesize(5)).
       It is strongly recommended that all related documentation be completely
       understood before setting a larger hostname.  A hostname larger than 64
       bytes can cause anomalous behavior or failure in applications which use
       the command or the system function to obtain the name.

AUTHOR
       was developed by the University of California, Berkeley.

SEE ALSO
       hostname(1),  uname(1),	gethostname(2), uname(2), nodehostnamesize(5),
       privileges(5).

								sethostname(2)

Vote for polarhome