HOSTNAMEUTILS(1) General Commands Manual HOSTNAMEUTILS(1) NAME gethostname - get local hostname. gethostbyname - get local host information for specified hostname. gethostbyaddr - get hostname via IP address. getservbyname - get configured port number of service SYNTAX gethostname [-help|-name|-aname|-all] gethostbyname [-help|-name|-aname|-all|-all_rr] gethostbyaddr [-help|-name|-aname|-all] getservbyname [-help|-number] DESCRIPTION gethostname and gethostbyname are used to get the local resolved host name. gethostbyaddr is used to get the hostname of a specified IP address (dotted decimal notation). getservbyname can be used to get the configured port number of a service (e.g. from /etc/services). The hostname utils are primarily used by the Univa Grid Engine instal- lation scripts. gethostname , gethostbyname and gethostbyaddr called without any option will print out the hostname, all specified aliases, and the IP address of the locally resolved hostname. Calling get- servbyname without any option will print out the full service entry. OPTIONS -help Prints a list of all options. -name This option only reports the primary name of the host. -aname If this option is set, the Univa Grid Engine host alias file is used for host name resolving. It is necessary to set the environment vari- able SGE_ROOT and, if more than one cell is defined, also SGE_CELL. This option will print out the Univa Grid Engine host name. -all By using the -all option all available host information will be printed. This information includes the host name, the Univa Grid Engine host name, all host aliases, and the IP address of the host. -all_rr (only for gethostbyname) The -all_rr option will enhance the -all option output. It will in addition try to contact the sge_qmaster daemon in order to resolve the specified hostname also on the sge_qmaster host. If the daemon is not running or cannot be contacted the command will print out errors and terminate with an error exit code. If the sge_qmaster host could be contacted successfully the output will include an extra line showing the resulting hostname on the sge_qmaster host and also the host name of the sge_qmaster service. -number This option will print out the port number of the specified service name. The host name for which the information is requested. The IP address (dotted decimal notation) for which the information is requested. The service name for which the information is requested (e.g. ftp, sge_qmaster or sge_execd). EXAMPLES The following example shows how to get the port number of the FTP ser- vice: >getservbyname -number ftp 21 The next example shows the output of gethostname -all when the host alias file contains this line: gridmaster extern_name extern_name.mydomain The local host resolving must also provide the alias name "gridmaster". Each Univa Grid Engine host that wants to use the cluster must be able to resolve the host name "gridmaster". To setup an alias name, edit your /etc/hosts file or modify your NIS setup to provide the alias for the NIS clients. The host alias file must be readable from each host (use e.g. NFS shared file location). >gethostname -all Hostname: extern_name.mydomain SGE name: gridmaster Aliases: loghost gridmaster Host Address(es): 192.168.143.99 ENVIRONMENTAL VARIABLES SGE_ROOT Specifies the location of the Univa Grid Engine standard configuration files. SGE_CELL If set, specifies the default Univa Grid Engine cell. SEE ALSO sge_intro(1), host_aliases(5), COPYRIGHT See sge_intro(1) for a full statement of rights and permissions. Univa Grid Engine User Commands UGE 8.5.4 HOSTNAMEUTILS(1)