---
name: "sge_hostgroup"
section: "5"
platform: "linux"
package: "gridengine-common"
version: "8.1.9+dfsg-13.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sge_hostgroup"
---

# sge\_hostgroup(5)

host group entry file format

## 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 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)](/qconf/1.md) **-shgrpl** option. The contents of each listed 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)](/qconf/1.md).

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

## FORMAT

A host group entry contains the 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)](/sge_types/5.md).

### hostlist

The names of all hosts and host groups (see *host\_identifier* in  [*sge\_types*(5)](/sge_types/5.md)) which are members of the group.  Only whitespace is allowed as list separators. The 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 a subgroup 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)](/qconf/1.md)

## COPYRIGHT

See [*sge\_intro*(1)](/sge_intro/1.md) for a full statement of rights and permissions.