@@ -203,6 +203,66 @@ that shared systems get regrooved occasionally even if nothing decides
to unshare them.
+ts-hosts-allocate-Executive and hostflags
+----------------------------------------
+
+Within a job, the allocations are actually done by
+ts-hosts-allocate-Executive. It is told what to do by its command
+line arguments, which are (usually) simply IDENTs.
+
+The IDENTs provide the key for runvars which control the host
+allocation algorithm. Principally, these are the runvars which define
+the job's hostflags
+ all_hostflags
+ IDENT_hostflags
+ runtime_IDENT_hostflags
+(all of these are comma-separated lists).
+
+Each such hostflag must, in general, be set for a particular host, for
+that host to be eligible. But there are some special forms of job
+hostflag:
+
+ share-SHARING
+
+ The host may be shared with other jobs. Typically used for
+ builds. SHARING is a string which denotes the "scope" of the
+ sharing - jobs with the same SHARING should set the host up
+ identically. The osstest test harness revision is automatically
+ appended and therefore does not need to be included.
+
+ equiv-FORMALTOKEN
+
+ For each equiv-FORMALTOKEN job flag set on one or more IDENTs, a
+ corresponding equiv-ACTUALTOKEN host flag must be set on the
+ corresponding hosts. So, for example, if the IDENTs src_host and
+ dst_host both have equiv-1 specified, then the two hosts chosen
+ for src_host and dst_host will have an actual hostflag in common
+ which matches the pattern equiv-*.
+
+ diverse-FORMATLTOKEN
+
+ For each diverse-FORMALTOKEN flag, the selected host will *not* be
+ the same as any other allocation with the same diverse-FORMALTOKEN
+ flag in the same *flight*.
+
+ CONDNAME:CONDARGS...
+
+ Looks up CONDNAME as Osstest::ResourceCondition::PROPNAME.
+ The selected host must match the appropriate condition.
+ CONDNAMEs are:
+
+ PropEq:HOSTPROP:VAL
+
+ Require the host property HOSTPROP to be equal to VAL,
+ according to string comparison. (Unset properties are
+ match an empty VAL.)
+
+ PropMinVer:HOSTPROP:VAL
+
+ Require the host property HOSTPROP to be at least VAL, according
+ to version number comparison (as implemented by dpkg and
+ coreutils).
+
Flights
-------
Signed-off-by: Ian Jackson <Ian.Jackson@eu.citrix.com> --- README.planner | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+)