gethostname()--Retrieve Host Name

  #include <sys/types.h>
  #include <sys/socket.h>

 int gethostname(char *name,
                 int length)

  #define _XOPEN_SOURCE 520
  #include <sys/socket.h>

 int gethostname(char *name,
                 socklen_t length)

The gethostname() function is used to retrieve the name of the host from the system.

There are two versions of the API, as shown above. The base i5/OS API uses BSD 4.3 structures and syntax. The other uses syntax and structures compatible with the UNIX 98 programming interface specifications. You can select the UNIX 98 compatible interface with the _XOPEN_SOURCE macro.

Parameters

name

(Output) The pointer to a character array where the host name is to be stored. The host name is NULL-terminated unless the length of the host name exceeds the length of the name parameter, in which case the host name is truncated to the size of the name parameter.

length

(Input) The length of the name parameter.

Authorities

No authorization is required.

Return Value

gethostname() returns an integer. Possible values are:

• -1 (unsuccessful)
  
  
• 0 (successful)

Error Conditions

When gethostname() fails, errno can be set to one of the following:

Error Messages

Usage Notes

1. Maximum length of host names is defined by {MAXHOSTNAMELEN} (defined in <sys/param.h>).
   
   
2. When a process issues a sethostname(), the host name can be accessed by any process that issues a gethostname().
   
   
3. On an initial program load, the host name is set to whatever was configured using the iSeries Navigator or option 12 (Change TCP/IP domain information) on the Configure TCP/IP (CFGTCP) menu. The local domain name is appended with the local host name and stored in system-wide storage. This combined name is the host name that can be retrieved by gethostname(). If the local host name and local domain name are not set, the host name is set to NULL.
   
   
4. The host name is returned in the default coded character set identifier (CCSID) currently in effect for the job.
   
   
5. When you develop in C-based languages and an application is compiled with the _XOPEN_SOURCE macro defined to the value 520 or greater, the gethostname() API is mapped to qso_gethostname98().

Related Information

• _XOPEN_SOURCE--Using _XOPEN_SOURCE for the UNIX 98 compatible interface
  
  
• sethostname()--Set Host Name
  
  
• gethostid()--Retrieve Host ID Address
  
  
• sethostid()--Set Host ID Address