Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gethostname(2) [osf1 man page]

gethostname(2)							System Calls Manual						    gethostname(2)

NAME
gethostname - Gets the name of the local host SYNOPSIS
#include <unistd.h> int gethostname ( char *name, size_t namelen ); The following definition of the gethostname() function does not conform to current standards and is supported only for backward compatibil- ity: #include <unistd.h> int gethostname ( char *name, int name_len ); STANDARDS
Interfaces documented on this reference page conform to industry standards as follows: gethostname(): XNS4.0 Refer to the standards(5) reference page for more information about industry standards and associated tags. PARAMETERS
Specifies the address of an array of bytes where the host name is stored. Specifies the length of the array pointed to by the name parame- ter. DESCRIPTION
The gethostname() function retrieves the host name of the local host as it is configured on the system. If a fully-qualified domain name is configured as the host name, that name is returned. If sufficient space is provided, the returned name is null-terminated. System host names are limited to MAXHOSTNAMELEN as defined in the /usr/include/sys/param.h file. The gethostname() function allows a calling process to determine the internal host name for a machine on a network. RETURN VALUES
Upon successful completion, a value of 0 (zero) is returned. Otherwise, a value of -1 is returned. If the version of gethostname() provided for backward compatibility returns a -1, errno is also set to indicate the error. ERRORS
If the gethostname() function provided for backward compatibility fails, errno may be set to the following value: The address parameter or address_len parameter gives an invalid address. RELATED INFORMATION
Functions: gethostid(2), sethostid(2), sethostname(2) Standards: standards(5) delim off gethostname(2)

Check Out this Related Man Page

gethostname(3C)                                            Standard C Library Functions                                            gethostname(3C)

NAME
gethostname, sethostname - get or set name of current host SYNOPSIS
#include <unistd.h> 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 sethostname(). The namelen argu- ment 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 restricted 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 <netdb.h> header. RETURN VALUES
Upon successful completion, gethostname() and sethostname() return 0. Otherwise, they return -1 and set errno to indicate the error. ERRORS
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 {PRIV_SYS_ADMIN} privilege was not asserted in the effective set of the calling process. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
sysinfo(2), uname(2), gethostid(3C), attributes(5), standards(5) SunOS 5.10 22 Mar 2004 gethostname(3C)
Man Page

Featured Tech Videos