Provided by: gridengine-common_6.2-4_all bug

NAME

       hostgroup - host group entry file format

DESCRIPTION

       A  host  group entry is used to merge host names to groups.  Each  host
       group  entry  file defines one group. Inside a  group  definition  file
       you  can also reference to groups. These groups are called subgroups. A
       subgroup is referenced by the sign "@" as first character of the  name.

       A  list of currently configured host group entries can be displayed via
       the qconf(1) -shgrpl option. The contents of each enlisted  host  group
       entry  can  be  shown  via  the  -shgrp  switch. The output follows the
       hostgroup format description. New host group entries can be created and
       existing  can  be  modified  via  the -ahgrp, -mhgrp, -dhgrp and -?attr
       options to qconf(1).

       Note, Sun Grid Engine allows backslashes (\) be used to escape  newline
       (\newline)  characters. The backslash and the newline are replaced with
       a space (" ") character before any interpretation.

FORMAT

       A host group entry contains following parameters:

   group_name
       The group_name defines the host group name. Host group  names  have  to
       begin  with  an  ’@’  character  as  explained  for  hostgroup_name  in
       sge_types(5).

   hostlist
       The  name  of  all  hosts  and  host  groups  (see  host_identifier  in
       sge_types(1))  which are member of the group. As list separators white-
       spaces are supported only. Default value for this parameter is NONE.

       Note, if the first character of the host_identifier is an "@" sign  the
       name is used to reference a hostgroup(5) which is taken as sub group of
       this group.

EXAMPLE

       This is a typical host group entry:

       group_name @bigMachines

       hostlist @solaris64 @solaris32 fangorn balrog

       The entry will define a new host group  called  @bigMachines.  In  this
       host  group  are  the  host fangorn, balrog and all members of the host
       groups @solaris64 and @solaris32.

SEE ALSO

       sge__types(1), qconf(1)

COPYRIGHT

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