aboutsummaryrefslogtreecommitdiff
path: root/doc/hosts.rst
blob: 885a4476967b6e55cb29b4fb61fb8eef57236934 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Hosts
=====

The HOSTATTRS list
------------------

This is a plist of lists, such that for each keyword symbol identifying a type
of static informational attribute, there is a list of entries.  Property
``:HOSTATTRS`` subroutines may only push new entries to the front of each such
sublist, using the function ``PUSH-HOSTATTR``.

The relationship between older and newer entries in the sublist for each type
of static informational attribute is attribute-dependent.  For example, for
the ``:DATA`` attribute, the order of entries does not matter and each item is
equally a piece of prerequisite data required by the host's properties.  For
other kinds of attribute, it might be that later entries supercede earlier
ones, or that the entries should be combined in some way.  Property ``:APPLY``
subroutines decide how to interpret each type of static informational
attribute.