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


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.



UGE 8.0.0                $Date: 2009/03/12 16:06:25 $         HOSTNAMEUTILS(1)