HostInfo

Description

Sets the NAME, DOMAIN, ADDR4, and ADDR6 properties in the current project.

The NAME contains the host part of the canonical name of the host.
If the host is not found, the host will contain the name as provided to the task, or localhost if no host was provided, and no name for the local host was found.
The DOMAIN contains the domain part of the canonical name of the host.
If the host is not found, the domain will contain the domain as provided to the task, or localdomain if no host / domain was provided.
The ADDR4 contains the IPv4 address of the host with the widest meaning.
If no IPv4 address is found and a host has been provided the address 0.0.0.0 is returned, when no host was provided the address 127.0.0.1 is returned.
The ADDR6 contains the IPv6 address of the host with the widest meaning.
If no IPv6 address is found and a host has been provided the address :: is returned, when no host was provided the address ::1 is returned.

These properties can be used in the build-file, for instance, to create host-stamped filenames, or used to replace placeholder tags inside documents to indicate, for example, the host where the build was performed on. The best place for this task is probably in an initialization target.

Parameters

Attribute Description Required
prefix Prefix used for all properties set. The default is no prefix. No
host The host to retrieve the information for, default is to retrieve information for the host the task is running on. No

Examples

  <hostinfo/>

Sets the NAME, DOMAIN, ADDR4, and ADDR6 for the local host, using the most "global" address available.

  <hostinfo prefix="remotehost" host="www.apache.org"/>

Sets the properties remotehost.NAME to eos, remotehost.DOMAIN to apache.org, remotehost.ADDR4 to 140.211.11.130 and remotehost.ADDR6 to :: for the host with the name www.apache.org (provided the canonical name and ip addresses do not change).