*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> gethostname (2)              



NAME    [Toc]    [Back]

       gethostname - Get the name of the local host

SYNOPSIS    [Toc]    [Back]

       #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 compatibility: #include <unistd.h>

       int gethostname(
               char *name,
               int name_len );

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       gethostname(): XNS4.0, XNS5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       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 parameter.

DESCRIPTION    [Toc]    [Back]

       The  gethostname() function retrieves the host name of the
       local host as it is configured on the system. If a  fullyqualified
 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    [Toc]    [Back]

       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

ERRORS    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

       Functions: gethostid(2), sethostid(2), sethostname(2)

       Standards: standards(5)

[ Back ]
 Similar pages
Name OS Title
tt_netfile_file HP-UX map between canonical and local pathnames on the local host
tt_file_netfile HP-UX map between local and canonical pathnames on the local host
rcp Tru64 Copies files on the same host, between a local host and a remote host, and between two remote hosts
protocols Tru64 Defines the Internet protocols used on the local host
local.users Tru64 Specifies mail recipients on the local host.
tt_host_netfile_file HP-UX map between canonical and local pathnames on a remote host
ruptime OpenBSD show host status of local machines
tt_host_file_netfile HP-UX map between local and canonical pathnames on a remote host
hostid Tru64 Sets or displays the identifier of the local host
ruptime IRIX show host status of local machines
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service