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] <name>

     gethostbyaddr [-help|-name|-aname|-all] <ip>

     getservbyname [-help|-number] <service>

DESCRIPTION
     gethostname and gethostbyname are  used  to  get  the  local
     resolved  host name.  gethostbyaddr is used to get the host-
     name 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 Sun Grid Engine
     installation   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  getservbyname  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 Sun Grid Engine host  alias  file
     is  used for host name resolving. It is necessary to set the
     environment variable SGE_ROOT and, if more than one cell  is
     defined, also SGE_CELL.

     This option will print out the Sun Grid Engine host name.


  -all
     By using the -all option all available host information will
     be  printed.   This  information includes the host name, the
     Sun Grid Engine host name, all  host  aliases,  and  the  IP
     address of the host.

  -number
     This option will print out the port number of the  specified
     service name.

  <name>
     The host name for which the information is requested.

  <ip>
     The IP address  (dotted  decimal  notation)  for  which  the
     information is requested.

  <service>
     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 service:

          >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  Sun  Grid Engine host that wants to use
     the cluster must be able to resolve the host name  "gridmas-
     ter".

     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 Sun Grid Engine
                    standard configuration files.

     SGE_CELL       If set, specifies the default Sun Grid Engine
                    cell.

SEE ALSO
     sge_intro(1), host_aliases(5),

COPYRIGHT
     See sge_intro(1) for a full statement of rights and  permis-
     sions.