HOSTNAMEUTILS(1)           Grid Engine User Commands          HOSTNAMEUTILS(1)



NNAAMMEE
       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

SSYYNNTTAAXX
       ggeetthhoossttnnaammee [[--hheellpp||--nnaammee||--aannaammee||--aallll]]

       ggeetthhoossttbbyynnaammee [[--hheellpp||--nnaammee||--aannaammee||--aallll]] <<nnaammee>>

       ggeetthhoossttbbyyaaddddrr [[--hheellpp||--nnaammee||--aannaammee||--aallll]] <<iipp>>

       ggeettsseerrvvbbyynnaammee [[--hheellpp||--nnuummbbeerr]] <<sseerrvviiccee>>


DDEESSCCRRIIPPTTIIOONN
       _g_e_t_h_o_s_t_n_a_m_e  and  _g_e_t_h_o_s_t_b_y_n_a_m_e are used to get the local resolved host
       name.  _g_e_t_h_o_s_t_b_y_a_d_d_r is used to get the  hostname  of  a  specified  IP
       address  (dotted  decimal  notation).  _g_e_t_s_e_r_v_b_y_n_a_m_e can be used to get
       the configured port number of a service (e.g. from /etc/services).

       The hostname utilities are primarily used by the Grid Engine  installa-
       tion  scripts.   _g_e_t_h_o_s_t_n_a_m_e  ,  _g_e_t_h_o_s_t_b_y_n_a_m_e and _g_e_t_h_o_s_t_b_y_a_d_d_r called
       without any option will print out the hostname, all specified  aliases,
       and  the  IP  address  of  the locally resolved hostname.  Calling _g_e_t_-
       _s_e_r_v_b_y_n_a_m_e without any option will print out the full service entry.


OOPPTTIIOONNSS
   --hheellpp
       Prints a list of all options.

   --nnaammee
       This option only reports the primary name of the host.

   --aannaammee
       If this option is set, the 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 Grid Engine host name.

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

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

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

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

   <<sseerrvviiccee>>
       The service name for which the  information  is  requested  (e.g.  ftp,
       sge_qmaster or sge_execd).

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

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       SSGGEE__RROOOOTT       Specifies  the location of the Grid Engine standard con-
                      figuration files.

       SSGGEE__CCEELLLL       If set, specifies the default Grid Engine cell.

SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1), _S_G_E___H___A_L_I_A_S_E_S(5),

CCOOPPYYRRIIGGHHTT
       See _s_g_e___i_n_t_r_o(1) for a full statement of rights and permissions.




GE 6.1                   $Date: 2007/06/26 22:21:08 $         HOSTNAMEUTILS(1)
