librelane 2.4.0__py3-none-any.whl

librelane/scripts/klayout/open_design.py

@@ -0,0 +1,63 @@
+# Copyright 2020-2022 Efabless Corporation
+# Copyright 2021 The American University in Cairo and the Cloud V Project
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import os
+import sys
+import shlex
+import argparse
+from typing import Tuple
+
+import pya  # Must be run inside KLayout-- the library version of pya does not include "Application"
+
+
+def open_design(input_lefs: Tuple[str, ...], lyt: str, lyp: str, lym: str, input: str):
+    try:
+        main_window = pya.Application.instance().main_window()
+
+        tech = pya.Technology()
+        tech.load(lyt)
+
+        layout_options = tech.load_layout_options
+        layout_options.keep_other_cells = True
+        layout_options.lefdef_config.macro_resolution_mode = 1
+        layout_options.lefdef_config.read_lef_with_def = False
+        layout_options.lefdef_config.lef_files = list(input_lefs)
+        layout_options.lefdef_config.map_file = lym
+
+        cell_view = main_window.load_layout(input, layout_options, 0)
+        layout_view = cell_view.view()
+        layout_view.load_layer_props(lyp)
+    except Exception as e:
+        print(e, file=sys.stderr)
+        pya.Application.instance().exit(1)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="Open design in KLayout")
+    parser.add_argument(
+        "-l",
+        "--input-lef",
+        action="append",
+        dest="input_lefs",
+        help="KLayout .lef files",
+    )
+    parser.add_argument("-T", "--lyt", required=True, help="KLayout .lyt file")
+    parser.add_argument("-P", "--lyp", required=True, help="KLayout .lyp file")
+    parser.add_argument(
+        "-M", "--lym", required=True, help="KLayout .map (LEF/DEF layer map) file"
+    )
+    parser.add_argument("input", help="KLayout cell name")
+
+    args = parser.parse_args(shlex.split(os.environ["KLAYOUT_ARGV"]))
+    open_design(args.input_lefs, args.lyt, args.lyp, args.lym, args.input)

librelane/scripts/klayout/render.py

@@ -0,0 +1,121 @@
+#!/usr/bin/env python3
+# Copyright (c) 2021-2022 Efabless Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Original Copyright Follows
+#
+# BSD 3-Clause License
+#
+# Copyright (c) 2018, The Regents of the University of California
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# * Redistributions of source code must retain the above copyright notice, this
+#   list of conditions and the following disclaimer.
+#
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+#
+# * Neither the name of the copyright holder nor the names of its
+#   contributors may be used to endorse or promote products derived from
+#   this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+from typing import Tuple
+
+import pya
+import click
+
+
+@click.command()
+@click.option("-o", "--output", required=True)
+@click.option(
+    "-l",
+    "--input-lef",
+    "input_lefs",
+    multiple=True,
+)
+@click.option(
+    "-T",
+    "--lyt",
+    required=True,
+    help="KLayout .lyt file",
+)
+@click.option(
+    "-P",
+    "--lyp",
+    required=True,
+    help="KLayout .lyp file",
+)
+@click.option(
+    "-M",
+    "--lym",
+    required=True,
+    help="KLayout .map (LEF/DEF layer map) file",
+)
+@click.argument("input")
+def render(
+    input_lefs: Tuple[str, ...],
+    output: str,
+    lyt: str,
+    lyp: str,
+    lym: str,
+    input: str,
+):
+    try:
+        gds = input.endswith(".gds")
+
+        # Load technology file
+        tech = pya.Technology()
+        tech.load(lyt)
+
+        layout_options = None
+        if not gds:
+            layout_options = tech.load_layout_options
+            layout_options.lefdef_config.map_file = lym
+            layout_options.lefdef_config.macro_resolution_mode = 1
+            layout_options.lefdef_config.read_lef_with_def = False
+            layout_options.lefdef_config.lef_files = list(input_lefs)
+
+        view = pya.LayoutView()
+        view.load_layer_props(lyp)
+
+        if gds:
+            view.load_layout(input)
+        else:
+            view.load_layout(input, layout_options, lyt)
+        view.max_hier()
+        pixels = view.get_pixels_with_options(1000, 1000)
+
+        with open(output, "wb") as f:
+            f.write(pixels.to_png_data())
+    except Exception as e:
+        print(e)
+        exit(1)
+
+
+if __name__ == "__main__":
+    render()

librelane/scripts/klayout/stream_out.py

@@ -0,0 +1,176 @@
+#!/usr/bin/env python3
+# Copyright (c) 2021-2022 Efabless Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Original Copyright Follows
+#
+# BSD 3-Clause License
+#
+# Copyright (c) 2018, The Regents of the University of California
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# * Redistributions of source code must retain the above copyright notice, this
+#   list of conditions and the following disclaimer.
+#
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+#
+# * Neither the name of the copyright holder nor the names of its
+#   contributors may be used to endorse or promote products derived from
+#   this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+import sys
+from typing import Tuple, Optional
+
+import pya
+import click
+
+
+@click.command()
+@click.option("-o", "--output", required=True)
+@click.option(
+    "-l",
+    "--input-lef",
+    "input_lefs",
+    multiple=True,
+)
+@click.option(
+    "-T",
+    "--lyt",
+    required=True,
+    help="KLayout .lyt file",
+)
+@click.option(
+    "-P",
+    "--lyp",
+    required=True,
+    help="KLayout .lyp file",
+)
+@click.option(
+    "-M",
+    "--lym",
+    required=True,
+    help="KLayout .map (LEF/DEF layer map) file",
+)
+@click.option("-w", "--with-gds-file", "input_gds_files", multiple=True, default=[])
+@click.option("-s", "--seal-gds-file", "seal_gds", default=None)
+@click.option(
+    "-t",
+    "--top",
+    "design_name",
+    required=True,
+    help="Name of the design/top module",
+)
+@click.argument(
+    "input",
+    type=click.Path(exists=True, file_okay=True, dir_okay=False),
+)
+def stream_out(
+    output: str,
+    input_lefs: Tuple[str, ...],
+    lyt: str,
+    lyp: str,
+    lym: str,
+    input_gds_files: Tuple[str, ...],
+    seal_gds: Optional[str],
+    design_name: str,
+    input: str,
+):  # Load technology file
+    try:
+        tech = pya.Technology()
+        tech.load(lyt)
+        layout_options = tech.load_layout_options
+        layout_options.lefdef_config.read_lef_with_def = False
+        layout_options.lefdef_config.lef_files = list(input_lefs)
+        layout_options.lefdef_config.map_file = lym
+
+        # Load def file
+        main_layout = pya.Layout()
+        # main_layout.load_layer_props(props_file)
+        main_layout.read(input, layout_options)
+
+        # Clear cells
+        top_cell_index = main_layout.cell(design_name).cell_index()
+
+        print("[INFO] Clearing cells…")
+        for i in main_layout.each_cell():
+            if i.cell_index() != top_cell_index:
+                if not i.name.startswith("VIA"):
+                    i.clear()
+
+        # Load in the gds to merge
+        print("[INFO] Merging GDS files…")
+        for gds in input_gds_files:
+            main_layout.read(gds)
+
+        # Copy the top level only to a new layout
+        print(f"[INFO] Copying top level cell '{design_name}'…")
+        top_only_layout = pya.Layout()
+        top_only_layout.dbu = main_layout.dbu
+        top = top_only_layout.create_cell(design_name)
+        top.copy_tree(main_layout.cell(design_name))
+
+        print("[INFO] Checking for missing GDS…")
+        missing_gds = False
+        for i in top_only_layout.each_cell():
+            if i.is_empty():
+                missing_gds = True
+                print(
+                    f"[ERROR] LEF Cell '{i.name}' has no matching GDS cell.",
+                    file=sys.stderr,
+                )
+
+        if missing_gds:
+            raise Exception("One or more cell GDS files are missing.")
+        else:
+            print("[INFO] All LEF cells have matching GDS cells.")
+
+        if seal_gds is not None:
+            top_cell = top_only_layout.top_cell()
+
+            print(f"[INFO] Reading seal GDS file '{seal_gds}'…")
+            top_only_layout.read(seal_gds)
+
+            for cell in top_only_layout.top_cells():
+                if cell != top_cell:
+                    print(
+                        f"[INFO] Merging '{cell.name}' as child of '{top_cell.name}'…"
+                    )
+                    top.insert(pya.CellInstArray(cell.cell_index(), pya.Trans()))
+
+        # Write out the GDS
+        print(f"[INFO] Writing out GDS '{output}'…")
+        top_only_layout.write(output)
+        print("[INFO] Done.")
+    except Exception as e:
+        print(e)
+        exit(1)
+
+
+if __name__ == "__main__":
+    stream_out()

librelane/scripts/klayout/xml_drc_report_to_json.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+# Copyright (c) 2023 Efabless Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import json
+
+from klayout.rdb import ReportDatabase
+import click
+
+
+@click.command()
+@click.option("--xml-file")
+@click.option("--json-file")
+def cli(xml_file, json_file):
+    database = ReportDatabase("Database")
+    json_database = {}
+    database.load(xml_file)
+    total = 0
+    for category in database.each_category():
+        num_items = category.num_items()
+        category_name = category.name()
+        json_database[category_name] = num_items
+        total += num_items
+
+    json_database = dict(sorted(json_database.items(), key=lambda item: item[1]))
+    json_database["total"] = total
+
+    with open(json_file, "w", encoding="utf8") as f:
+        json.dump(json_database, f, indent=4)
+
+    print(f"%OL_METRIC_I klayout__drc_error__count {total}")
+
+
+if __name__ == "__main__":
+    cli()

librelane/scripts/klayout/xor.drc

@@ -0,0 +1,120 @@
+#!/usr/bin/env ruby
+# A general XOR script from: https://www.klayout.de/forum/discussion/100/xor-vs-diff-tool
+
+# This script uses KLayout's Ruby-based DRC language to implement a generic
+# XOR between two layouts. The names of the layouts are given in global variables
+# $a and $b.
+
+if !defined?(RBA)
+  require 'optparse'
+
+  options = {
+    :rpt_out => "/dev/null"
+  }
+  optparse = OptionParser.new do |opts|
+    opts.banner = "Usage: #{File.basename($0)} [options] <GDS A> <GDS B>"
+
+    opts.on("-o", "--output OUTPUT", "Klayout RDB (.xml) output file (required)") do |rdb_out|
+      options[:rdb_out] = rdb_out
+    end
+    opts.on("-i", "--ignore SEMICOLON_DELIMITED_LIST", "Ignore layer(s)") do |ignore|
+      options[:ignore] = ignore
+    end
+    opts.on("-t", "--top TOP_CELL", "Top cell name (required)") do |top_cell|
+      options[:top_cell] = top_cell
+    end
+    opts.on("-t", "--tile-size TILE_SIZE", "Tile size (in µm)") do |tile_size|
+      options[:tile_size] = tile_size.to_i
+    end
+    opts.on("-n", "--threads THREAD_COUNT", "Lower bound on the thread count used by this process (+ managing threads)") do |threads|
+      options[:threads] = threads.to_i
+    end
+  end
+  optparse.parse!
+
+  if [options[:rdb_out], options[:top_cell]].include?(nil)
+    puts optparse.help
+    exit 64
+  end
+
+  args = [
+    "klayout", "-b",
+    "-r", $0,
+    "-rd", "top_cell=#{options[:top_cell]}",
+    "-rd", "a=#{ARGV[0]}",
+    "-rd", "b=#{ARGV[1]}",
+    "-rd", "jobs=#{options[:threads]}",
+    "-rd", "rdb_out=#{File.absolute_path(options[:rdb_out])}",
+    "-rd", "ignore=#{options[:ignore]}",
+    "-rd", "tilesize=#{options[:tile_size]}",
+  ]
+  puts "Running: '#{args.join(" ")}'…"
+  exec *args
+
+end
+
+verbose
+
+# Run XOR
+if $jobs == ""
+  $jobs = "1"
+end
+$jobs = $jobs.to_i
+
+info "Using #{$jobs} threads…"
+threads($jobs)
+
+# Tiling
+if $tilesize == ""
+  $tilesize = "500"
+end
+$tilesize = $tilesize.to_i
+
+info "Using a tile size of (#{$tilesize} µm)²…"
+tiles($tilesize.um, $tilesize.um)
+
+# Set up inputs
+puts $a, $b
+a = source($a, $top_cell)
+b = source($b, $top_cell)
+
+# Set up output
+# target($gds_out, "XOR")
+report("XOR #{$a} vs. #{$b}", $rdb_out)
+
+def write_data(xor_data, layer_info)
+  xor_data.output(layer_info.to_s, "XOR data for layer #{layer_info.to_s}")
+end
+
+## Collect all common layers
+layers = {}
+[ a.layout, b.layout ].each do |ly|
+  ly.layer_indices.each do |li|
+    i = ly.get_info(li)
+    layers[i.to_s] = i
+  end
+end
+
+ignore_list = $ignore.split(";")
+
+## Perform per-layer XOR
+total_xor_differences = 0
+layers.sort.uniq.each do |layer_name, layer_data|
+  if ignore_list.include? layer_name
+    warn "--- Skipping #{layer_name}… ---"
+  else
+    info "--- Running XOR for layer #{layer_name} ---"
+
+    layer_info = layers[layer_name]
+    xor_data = (a.input(layer_name, layer_data) ^ b.input(layer_name, layer_data))
+    total_xor_differences += xor_data.data.size
+    info "XOR differences: #{xor_data.data.size}"
+
+    write_data xor_data, layer_info
+   end
+end
+
+info "---"
+info "Total XOR differences: #{total_xor_differences}"
+
+puts "%OL_METRIC_I design__xor_difference__count #{total_xor_differences}"

librelane/scripts/magic/Readme.md

@@ -0,0 +1 @@
+Files here are categorized by the input format. `drc.tcl` and `extract_spice.tcl` accept both GDS and DEF depending on a flag.

librelane/scripts/magic/common/read.tcl

@@ -0,0 +1,114 @@
+# Copyright 2022 Efabless Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+proc read_pdk_gds {} {
+    set old_rescale [gds rescale]
+    set old_readonly [gds readonly]
+    gds rescale false
+    gds readonly true
+    set gds_files_in $::env(CELL_GDS)
+    foreach gds_file $gds_files_in {
+        puts "> gds read $gds_file"
+        gds read $gds_file
+    }
+    gds rescale $old_rescale
+    gds readonly $old_readonly
+}
+
+proc read_tech_lef {} {
+    puts "> lef read $::env(TECH_LEF)"
+    lef read $::env(TECH_LEF)
+}
+
+proc read_macro_lef {} {
+    if { [info exist ::env(MACRO_LEFS)] } {
+        foreach lef_file $::env(MACRO_LEFS) {
+            puts "> lef read $lef_file"
+            lef read $lef_file
+        }
+    }
+}
+
+proc read_extra_lef {} {
+    if { [info exist ::env(EXTRA_LEFS)] } {
+        foreach lef_file $::env(EXTRA_LEFS) {
+            puts "> lef read $lef_file"
+            lef read $lef_file
+        }
+    }
+}
+
+proc read_extra_gds {} {
+    set old_rescale [gds rescale]
+    set old_readonly [gds readonly]
+    gds rescale false
+    gds readonly true
+    if {  [info exist ::env(EXTRA_GDS_FILES)] } {
+        set gds_files_in $::env(EXTRA_GDS_FILES)
+        foreach gds_file $gds_files_in {
+            puts "> gds read $gds_file"
+            gds read $gds_file
+        }
+    }
+    gds rescale $old_rescale
+    gds readonly $old_readonly
+}
+
+proc read_macro_gds_blackbox {} {
+    if { [info exists ::env(__MACRO_GDS)] } {
+        foreach macro $::env(__MACRO_GDS) {
+            set macro_name [lindex $macro 0]
+            set gds_file [lindex $macro 1]
+            set bbox [lindex $macro 2]
+            load $macro_name
+            property LEFview true
+            property GDS_FILE $gds_file
+            property GDS_START 0
+            property FIXED_BBOX "$bbox"
+            puts "[property]"
+            puts "> set GDS_FILE of $macro_name to $gds_file"
+        }
+    }
+}
+
+proc read_macro_gds {} {
+    if { [info exist ::env(MACRO_GDS_FILES)] } {
+        set gds_files_in $::env(MACRO_GDS_FILES)
+        foreach gds_file $gds_files_in {
+            puts "> gds read $gds_file"
+            gds read $gds_file
+        }
+    }
+}
+
+proc read_pdk_lef {} {
+    foreach lef_file $::env(CELL_LEFS) {
+        puts "> lef read $lef_file"
+        lef read $lef_file
+    }
+}
+
+proc read_def {} {
+    set def_read_args [list]
+    lappend def_read_args $::env(CURRENT_DEF)
+    if { $::env(MAGIC_DEF_NO_BLOCKAGES) } {
+        lappend def_read_args -noblockage
+    }
+    if { $::env(MAGIC_DEF_LABELS) } {
+        lappend def_read_args -labels
+    }
+    puts "> def read $def_read_args"
+    def read {*}$def_read_args
+}

librelane/scripts/magic/def/antenna_check.tcl

@@ -0,0 +1,35 @@
+# Copyright 2020-2022 Efabless Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+source $::env(SCRIPTS_DIR)/magic/def/read.tcl
+
+load $::env(DESIGN_NAME) -dereference
+
+set extdir $::env(signoff_tmpfiles)/magic_antenna_ext
+file mkdir $extdir
+cd $extdir
+
+select top cell
+extract do local
+extract no capacitance
+extract no coupling
+extract no resistance
+extract no adjust
+if { ! $::env(MAGIC_NO_EXT_UNIQUE) } {
+    extract unique
+}
+extract
+feedback save $::env(_tmp_feedback_file)
+
+antennacheck debug
+antennacheck

librelane/scripts/magic/def/mag.tcl

@@ -0,0 +1,19 @@
+# Copyright 2020-2022 Efabless Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+source $::env(SCRIPTS_DIR)/magic/def/read.tcl
+
+save $::env(SAVE_MAG)
+
+puts "[INFO] Done exporting $::env(SAVE_MAG)."