diff --git a/docs/manual/CoreTasks/hostinfo.html b/docs/manual/CoreTasks/hostinfo.html new file mode 100644 index 000000000..48efa826f --- /dev/null +++ b/docs/manual/CoreTasks/hostinfo.html @@ -0,0 +1,98 @@ + + + +
+ + +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.
+ +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 | +
+ <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
name>,
+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).
+