2020-02-27 13:18:25 +02:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
< html >
< head >
< title > 3/bs< / title >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" >
< meta http-equiv = "Content-Language" content = "en-gb" >
< link href = "inweb.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< / head >
< body >
<!-- Weave of '3/bs2' generated by 7 -->
< ul class = "crumbs" > < li > < a href = "../webs.html" > ★ < / a > < / li > < li > < a href = "index.html" > inbuild< / a > < / li > < li > < a href = "index.html#3" > Chapter 3: Incremental Builds< / a > < / li > < li > < b > Build Steps< / b > < / li > < / ul > < p class = "purpose" > A build step is a task which exercises one of the build skills.< / p >
< ul class = "toc" > < li > < a href = "#SP1" > § 1. Build skills< / a > < / li > < li > < a href = "#SP3" > § 3. Build steps< / a > < / li > < / ul > < hr class = "tocbar" >
< p class = "inwebparagraph" > < a id = "SP1" > < / a > < b > § 1. Build skills. < / b > < / p >
< pre class = "display" >
< span class = "reserved" > typedef< / span > < span class = "plain" > < / span > < span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > build_skill< / span > < span class = "plain" > {< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > name< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > METHOD_CALLS< / span >
< span class = "identifier" > MEMORY_MANAGEMENT< / span >
< span class = "plain" > } < / span > < span class = "reserved" > build_skill< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > build_skill< / span > < span class = "plain" > *< / span > < span class = "functiontext" > BuildSteps::new_skill< / span > < span class = "plain" > (< / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > name< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > build_skill< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > = < / span > < span class = "identifier" > CREATE< / span > < span class = "plain" > (< / span > < span class = "reserved" > build_skill< / span > < span class = "plain" > );< / span >
< span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > name< / span > < span class = "plain" > = < / span > < span class = "identifier" > Str::duplicate< / span > < span class = "plain" > (< / span > < span class = "identifier" > name< / span > < span class = "plain" > );< / span >
< span class = "identifier" > ENABLE_METHOD_CALLS< / span > < span class = "plain" > (< / span > < span class = "identifier" > S< / span > < span class = "plain" > );< / span >
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > S< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > The function BuildSteps::new_skill is used in 3/is (< a href = "3-is.html#SP1" > § 1< / a > ), 3/is2 (< a href = "3-is2.html#SP1" > § 1< / a > ), 3/is3 (< a href = "3-is3.html#SP1" > § 1< / a > ), 3/is4 (< a href = "3-is4.html#SP1" > § 1< / a > ).< / p >
< p class = "endnote" > The structure build_skill is private to this section.< / p >
< p class = "inwebparagraph" > < a id = "SP2" > < / a > < b > § 2. < / b > < / p >
< pre class = "definitions" >
< span class = "definitionkeyword" > enum< / span > < span class = "constant" > BUILD_SKILL_COMMAND_MTID< / span >
< span class = "definitionkeyword" > enum< / span > < span class = "constant" > BUILD_SKILL_INTERNAL_MTID< / span >
< / pre >
< pre class = "display" >
< span class = "identifier" > VMETHOD_TYPE< / span > < span class = "plain" > (< / span > < span class = "constant" > BUILD_SKILL_COMMAND_MTID< / span > < span class = "plain" > ,< / span >
< span class = "reserved" > build_skill< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > , < / span > < span class = "reserved" > build_step< / span > < span class = "plain" > *< / span > < span class = "identifier" > BS< / span > < span class = "plain" > , < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > command< / span > < span class = "plain" > , < / span > < span class = "reserved" > build_methodology< / span > < span class = "plain" > *< / span > < span class = "identifier" > meth< / span > < span class = "plain" > )< / span >
< span class = "identifier" > IMETHOD_TYPE< / span > < span class = "plain" > (< / span > < span class = "constant" > BUILD_SKILL_INTERNAL_MTID< / span > < span class = "plain" > ,< / span >
< span class = "reserved" > build_skill< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > , < / span > < span class = "reserved" > build_step< / span > < span class = "plain" > *< / span > < span class = "identifier" > BS< / span > < span class = "plain" > , < / span > < span class = "reserved" > build_methodology< / span > < span class = "plain" > *< / span > < span class = "identifier" > meth< / span > < span class = "plain" > )< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP3" > < / a > < b > § 3. Build steps. < / b > < / p >
< pre class = "display" >
< span class = "reserved" > typedef< / span > < span class = "plain" > < / span > < span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > build_step< / span > < span class = "plain" > {< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > build_skill< / span > < span class = "plain" > *< / span > < span class = "identifier" > what_to_do< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > build_vertex< / span > < span class = "plain" > *< / span > < span class = "identifier" > vertex< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > linked_list< / span > < span class = "plain" > *< / span > < span class = "identifier" > search_path< / span > < span class = "plain" > ; < / span > < span class = "comment" > of < code class = "display" > < span class = "extract" > inbuild_nest< / span > < / code > < / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > target_vm< / span > < span class = "plain" > *< / span > < span class = "identifier" > for_vm< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > inter_architecture< / span > < span class = "plain" > *< / span > < span class = "identifier" > for_arch< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > for_release< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > inbuild_copy< / span > < span class = "plain" > *< / span > < span class = "identifier" > associated_copy< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > MEMORY_MANAGEMENT< / span >
< span class = "plain" > } < / span > < span class = "reserved" > build_step< / span > < span class = "plain" > ;< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
2020-03-11 02:21:09 +02:00
< p class = "endnote" > The structure build_step is accessed in 2/cps, 3/bg, 3/is, 3/is2, 3/is3, 3/is4, 4/km, 5/kts, 5/ps, 6/hdn, 6/inc and here.< / p >
2020-02-27 13:18:25 +02:00
< p class = "inwebparagraph" > < a id = "SP4" > < / a > < b > § 4. < / b > < / p >
< pre class = "display" >
< span class = "reserved" > build_step< / span > < span class = "plain" > *< / span > < span class = "functiontext" > BuildSteps::attach< / span > < span class = "plain" > (< / span > < span class = "reserved" > build_vertex< / span > < span class = "plain" > *< / span > < span class = "identifier" > vertex< / span > < span class = "plain" > , < / span > < span class = "reserved" > build_skill< / span > < span class = "plain" > *< / span > < span class = "identifier" > to_do< / span > < span class = "plain" > , < / span > < span class = "identifier" > linked_list< / span > < span class = "plain" > *< / span > < span class = "identifier" > search< / span > < span class = "plain" > ,< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > rel< / span > < span class = "plain" > , < / span > < span class = "identifier" > target_vm< / span > < span class = "plain" > *< / span > < span class = "identifier" > VM< / span > < span class = "plain" > , < / span > < span class = "identifier" > inter_architecture< / span > < span class = "plain" > *< / span > < span class = "identifier" > arch< / span > < span class = "plain" > , < / span > < span class = "reserved" > inbuild_copy< / span > < span class = "plain" > *< / span > < span class = "identifier" > assoc< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > build_step< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > = < / span > < span class = "identifier" > CREATE< / span > < span class = "plain" > (< / span > < span class = "reserved" > build_step< / span > < span class = "plain" > );< / span >
< span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > vertex< / span > < span class = "plain" > = < / span > < span class = "identifier" > vertex< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > what_to_do< / span > < span class = "plain" > = < / span > < span class = "identifier" > to_do< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > search_path< / span > < span class = "plain" > = < / span > < span class = "identifier" > search< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > for_vm< / span > < span class = "plain" > = < / span > < span class = "identifier" > VM< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > for_arch< / span > < span class = "plain" > = < / span > < span class = "identifier" > arch< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > if< / span > < span class = "plain" > ((< / span > < span class = "identifier" > VM< / span > < span class = "plain" > ) & & (< / span > < span class = "identifier" > arch< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > )) < / span > < span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > for_arch< / span > < span class = "plain" > = < / span > < span class = "identifier" > TargetVMs::get_architecture< / span > < span class = "plain" > (< / span > < span class = "identifier" > VM< / span > < span class = "plain" > );< / span >
< span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > for_release< / span > < span class = "plain" > = < / span > < span class = "identifier" > rel< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > associated_copy< / span > < span class = "plain" > = < / span > < span class = "identifier" > assoc< / span > < span class = "plain" > ;< / span >
< span class = "functiontext" > BuildScripts::add_step< / span > < span class = "plain" > (< / span > < span class = "identifier" > vertex< / span > < span class = "plain" > -< / span > < span class = "element" > > script< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > );< / span >
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > S< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "functiontext" > BuildSteps::execute< / span > < span class = "plain" > (< / span > < span class = "reserved" > build_vertex< / span > < span class = "plain" > *< / span > < span class = "identifier" > V< / span > < span class = "plain" > , < / span > < span class = "reserved" > build_step< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > , < / span > < span class = "reserved" > build_methodology< / span > < span class = "plain" > *< / span > < span class = "identifier" > meth< / span > < span class = "plain" > ) {< / span >
2020-03-11 02:21:09 +02:00
< span class = "comment" > PRINT("Exec %S %d\n", S-> what_to_do-> name, meth-> methodology);< / span >
2020-02-27 13:18:25 +02:00
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > rv< / span > < span class = "plain" > = < / span > < span class = "identifier" > TRUE< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > command< / span > < span class = "plain" > );< / span >
< span class = "identifier" > VMETHOD_CALL< / span > < span class = "plain" > (< / span > < span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > what_to_do< / span > < span class = "plain" > , < / span > < span class = "constant" > BUILD_SKILL_COMMAND_MTID< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > , < / span > < span class = "identifier" > command< / span > < span class = "plain" > , < / span > < span class = "identifier" > meth< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > ((< / span > < span class = "identifier" > rv< / span > < span class = "plain" > ) & & (< / span > < span class = "identifier" > Str::len< / span > < span class = "plain" > (< / span > < span class = "identifier" > command< / span > < span class = "plain" > ) > 0)) < / span > < span class = "identifier" > rv< / span > < span class = "plain" > = < / span > < span class = "functiontext" > BuildSteps::shell< / span > < span class = "plain" > (< / span > < span class = "identifier" > command< / span > < span class = "plain" > , < / span > < span class = "identifier" > meth< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > ((< / span > < span class = "identifier" > rv< / span > < span class = "plain" > ) & & (< / span > < span class = "identifier" > meth< / span > < span class = "plain" > -< / span > < span class = "element" > > methodology< / span > < span class = "plain" > == < / span > < span class = "constant" > INTERNAL_METHODOLOGY< / span > < span class = "plain" > )) {< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > returned< / span > < span class = "plain" > = 0;< / span >
< span class = "identifier" > IMETHOD_CALL< / span > < span class = "plain" > (< / span > < span class = "identifier" > returned< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -< / span > < span class = "element" > > what_to_do< / span > < span class = "plain" > , < / span > < span class = "constant" > BUILD_SKILL_INTERNAL_MTID< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > , < / span > < span class = "identifier" > meth< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > returned< / span > < span class = "plain" > != < / span > < span class = "identifier" > TRUE< / span > < span class = "plain" > ) < / span > < span class = "identifier" > rv< / span > < span class = "plain" > = < / span > < span class = "identifier" > FALSE< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
2020-03-11 02:21:09 +02:00
< span class = "plain" > #< / span > < span class = "identifier" > ifndef< / span > < span class = "plain" > < / span > < span class = "identifier" > CORE_MODULE< / span >
2020-02-27 13:18:25 +02:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > rv< / span > < span class = "plain" > == < / span > < span class = "identifier" > FALSE< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > STDERR< / span > < span class = "plain" > , < / span > < span class = "string" > "Build failed at '%S'\< / span > < span class = "plain" > n< / span > < span class = "string" > "< / span > < span class = "plain" > , < / span > < span class = "identifier" > command< / span > < span class = "plain" > );< / span >
2020-03-11 02:21:09 +02:00
< span class = "plain" > #< / span > < span class = "identifier" > endif< / span >
2020-02-27 13:18:25 +02:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > command< / span > < span class = "plain" > );< / span >
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > rv< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "functiontext" > BuildSteps::shell< / span > < span class = "plain" > (< / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > command< / span > < span class = "plain" > , < / span > < span class = "reserved" > build_methodology< / span > < span class = "plain" > *< / span > < span class = "identifier" > meth< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > rv< / span > < span class = "plain" > = < / span > < span class = "identifier" > TRUE< / span > < span class = "plain" > ;< / span >
2020-03-11 02:21:09 +02:00
< span class = "plain" > #< / span > < span class = "identifier" > ifndef< / span > < span class = "plain" > < / span > < span class = "identifier" > CORE_MODULE< / span >
2020-02-27 13:18:25 +02:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > STDOUT< / span > < span class = "plain" > , < / span > < span class = "string" > "%S\< / span > < span class = "plain" > n< / span > < span class = "string" > "< / span > < span class = "plain" > , < / span > < span class = "identifier" > command< / span > < span class = "plain" > );< / span >
2020-03-11 02:21:09 +02:00
< span class = "plain" > #< / span > < span class = "identifier" > endif< / span >
2020-02-27 13:18:25 +02:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > meth< / span > < span class = "plain" > -< / span > < span class = "element" > > methodology< / span > < span class = "plain" > == < / span > < span class = "constant" > SHELL_METHODOLOGY< / span > < span class = "plain" > ) < / span > < span class = "identifier" > rv< / span > < span class = "plain" > = (< / span > < span class = "identifier" > Shell::run< / span > < span class = "plain" > (< / span > < span class = "identifier" > command< / span > < span class = "plain" > ) == 0)?< / span > < span class = "identifier" > TRUE< / span > < span class = "plain" > :< / span > < span class = "identifier" > FALSE< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > rv< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > The function BuildSteps::attach is used in 5/kts (< a href = "5-kts.html#SP2" > § 2< / a > ), 5/ps (< a href = "5-ps.html#SP3" > § 3< / a > ).< / p >
< p class = "endnote" > The function BuildSteps::execute is used in 3/bs (< a href = "3-bs.html#SP1" > § 1< / a > ).< / p >
< p class = "endnote" > The function BuildSteps::shell is used in 4/em (< a href = "4-em.html#SP8" > § 8< / a > ), 4/pm (< a href = "4-pm.html#SP7" > § 7< / a > ).< / p >
< hr class = "tocbar" >
< ul class = "toc" > < li > < a href = "3-bs.html" > Back to 'Build Scripts'< / a > < / li > < li > < a href = "3-is.html" > Continue with 'Inter Skill'< / a > < / li > < / ul > < hr class = "tocbar" >
<!-- End of weave -->
< / body >
< / html >