hostgroup (5) - Linux Manuals

hostgroup: host group entry file format


hostgroup - host group entry file format


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

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


A host group entry contains the following parameters:


The group_name defines the host group name. Host group names have to begin with an '@' character as explained for hostgroup_name in


The names of all hosts and host groups (see host_identifier in 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 which is taken as a subgroup of this group.


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 for a full statement of rights and permissions.