Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for sethostname (redhat section 2)

GETHOSTNAME(2)			    Linux Programmer's Manual			   GETHOSTNAME(2)

NAME
       gethostname, sethostname - get/set host name

SYNOPSIS
       #include <unistd.h>

       int gethostname(char *name, size_t len);
       int sethostname(const char *name, size_t len);

DESCRIPTION
       These  functions  are  used to access or to change the host name of the current processor.
       The gethostname() function returns a NUL-terminated  hostname  (set  earlier  by  sethost-
       name())	in  the  array	name  that has a length of len bytes.  In case the NUL-terminated
       hostname does not fit, no error is returned, but the hostname is truncated. It is unspeci-
       fied whether the truncated hostname will be NUL-terminated.

RETURN VALUE
       On success, zero is returned.  On error, -1 is returned, and errno is set appropriately.

ERRORS
       EINVAL len  is  negative or, for sethostname, len is larger than the maximum allowed size,
	      or, for gethostname on Linux/i386, len is smaller than the actual size.	(In  this
	      last case glibc 2.1 uses ENAMETOOLONG.)

       EPERM  For sethostname, the caller was not the superuser.

       EFAULT name is an invalid address.

CONFORMING TO
       SVr4, 4.4BSD  (this function first appeared in 4.2BSD).	POSIX 1003.1-2001 specifies geth-
       ostname but not sethostname.

BUGS
       For many Linux kernel / libc combinations gethostname will  return  an  error  instead  of
       returning a truncated hostname.

NOTES
       SUSv2 guarantees that `Host names are limited to 255 bytes'.  POSIX 1003.1-2001 guarantees
       that `Host names (not including the terminating NUL) are limited to HOST_NAME_MAX bytes'.

SEE ALSO
       getdomainname(2), setdomainname(2), uname(2)

Linux 2.5.0				    2001-12-15				   GETHOSTNAME(2)


All times are GMT -4. The time now is 08:50 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password