This is a read-only mirror of the HSC engineering wiki, restored from a 2017 archive. Some links are broken and some content is out of date. About this mirror.

Legacy Toolchain

From ANTFARM Wiki

Jump to: navigation, search
This is an old revision of this page, as archived. The mirror serves the archived text for every revision id.
⌛This page has not been updated since 2013-05-17 and may describe behaviour that no longer exists.
Legacy Toolchain
Compilerantc 0.6 – 1.4
Languagetask graph (.tg)
Ownertqian (left 2013)
Statusstale
Archive refQUANTARA-SWARMGLASS-R32-879331

Contents

[hide]

The legacy toolchain is antc, the task-graph compiler, plus the shell scripts around it that built and shipped forager releases until 3.0 moved everything to the container pipeline. It is called "legacy" on this wiki from 2014 onward; before that it was just "the toolchain".

antc takes a .tg file (Task Graph Format), validates it against the tool manifest from the Tool Registry, and emits the node bundle the queen hands out with task.assign.

[edit] Commands

antc check  graph.tg                 # validate only
antc build  graph.tg -o graph.bundle # compile
antc test   --model M --runtime R    # compatibility test, see Model_Compatibility_Matrix
antc shard  --model M --split N      # produce shard plan for mload2 (1.4+)
antc graph  graph.tg --dot | dot -Tpng > graph.png

[edit] Versions

antcDateNotes
0.62009-12first version that survived a week
0.92010-08manifest validation
1.02011-04frozen with IACP 1.1
1.22012-09API v2 bundles
1.42014-10shard subcommand, last release. tqian had left; r.osei did this one.

[edit] Build notes

The pre-2012 build was a nest of shell scripts on build.hm.internal. Notes survive at Legacy Toolchain/Pre-2012 Build Notes, including the appendix nobody was supposed to need again.

[edit] Known issues

  • antc check accepts graphs with cycles if the cycle passes through a model.* node. Fixed in 1.2, regressed in 1.4.
  • The --dot output uses the tool name as a node id, so two calls to the same tool collapse into one box. Cosmetic, misleading.
  • Bundles embed the absolute manifest path. Moving toolreg broke every bundle built before 2012-11.

[edit] Retirement

The container pipeline (never documented here; it lived in the build repo README) replaced everything except antc shard, which was still used at retirement because nobody rewrote it. The Retirement Plan 2016 lists it as "keep, do not touch".

[edit] See also

Revision 24 · tqian, mkerrigan · history · alternates: txt
Retrieved from "https://swarmglass.quantara.cv/wiki/Legacy_Toolchain"
Personal tools