/usr/share/doc/magic/html/calma.html is in magic 7.5.233-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 | <HTML>
<HEAD>
<STYLE type="text/css">
H1 {color: black }
H2 {color: maroon }
H3 {color: #007090 }
A.head:link {color: #0060a0 }
A.head:visited {color: #3040c0 }
A.head:active {color: white }
A.head:hover {color: yellow }
A.red:link {color: red }
A.red:visited {color: maroon }
A.red:active {color: yellow }
</STYLE>
</HEAD>
<TITLE>Magic-7.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title2.gif ALT="Magic VLSI Layout Tool Version 7.3">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>gds, calma</H2>
<HR>
Read GDSII input or generate GDSII output.
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>gds</B> [<I>option</I>] <BR><BR>
<B>calma</B> [<I>option</I>] <BR><BR>
<BLOCKQUOTE>
where <I>option</I> is one of the following:
<DL>
<DT> <B>help</B>
<DD> Print usage information
<DT> <B>arrays</B> [<B>yes</B>|<B>no</B>]
<DD> Output arrays as individual subuses (like in CIF). Default
is "no". Normally there is no reason to do this.
<DT> <B>contacts</B> [<B>yes</B>|<B>no</B>]
<DD> Causes contacts to be written to the GDS file as subcell
arrays (experimental, introduced in version 7.3.55). This
method can produce very efficient output compared to writing
each contact cut square separately.
<DT> <B>flatten</B> [<B>yes</B>|<B>no</B>]
<DD> Flatten simple cells (e.g., contacts) on input. This helps
magic to use its contact-area representation of contacts,
and can also avoid situations where contacts are lost or
translated to "generic" types because the arrayed part of
the contacts is missing one or more residue layers.
<DT> <B>ordering</B> [<B>yes</B>|<B>no</B>]
<DD> Forces post-ordering of subcells read from a GDS file; that
is, if a cell use is encountered before it is defined, magic
will read through the remainder of the file until it finds
the definition, read it, and then return to the original file
position to continue reading. This option is always enabled
when using <B>gds flatten</B>. Otherwise, the default behavior
is <B>ordering no</B> to avoid lengthy searches through the
GDS stream file.
<DT> <B>labels</B> [<B>yes</B>|<B>no</B>]
<DD> Cause labels to be output when writing GDSII. Default
is "yes". Normally there is no reason not to do this.
<DT> <B>lower</B> [<B>yes</B>|<B>no</B>]
<DD> Allow both upper and lower case in labels. Default is "yes".
<DT> <B>read</B> <I>file</I>
<DD> Read GDSII format from file <I>file</I> into the edit cell.
If <I>file</I> does not have a file extension, then <B>magic</B>
searches for a file named <I>file</I>, <I>file</I>.gds,
<I>file</I>.gds2, or <I>file</I>.strm.
<DT> <B>readonly</B> [<B>yes</B>|<B>no</B>]
<DD> Set cell as "read-only". This has the effect of marking each
cell definition (using the <B>property</B> method) with the
start and end positions of the cell definition in the input
file. In subsequent output, the cell definition will be
transferred verbatim from the input to the output file. This
is useful for 3rd-party standard cells or pad cells where the
original GDS is trusted and it is desirable to bypass the
boolean operators of <B>magic</B>'s GDS reader and writer to
prevent the layout from being altered. Note that "read-only"
layout can be written to a <TT>.mag</TT> file, but the
contents of this file are representational only. It can
be useful to keep a simplified respresentation in the case
of pad cells or digital standard cells, for example, by
reading them using a GDS input style that defines only metal
layers.
<DT> <B>rescale</B> [<B>yes</B>|<B>no</B>]
<DD> Allow or disallow internal grid subdivision while reading
GDS input. Default is "yes". Normally, one wants to allow
rescaling to ensure that the GDS is displayed exactly as it
is in the input file. Occasionally, however, the GDS input
is on a very fine scale, such as nanometers, and it is
preferable to snap the input to lambda boundaries rather
than to subsplit the internal grid to such a fine value.
The "<B>cif limit</B>" function may also be used to limit
grid subdivision to a minimum value.
<DT> <B>warning</B> [<I>option</I>]
<DD> Set warning information level. "<I>option</I>" may be one
of the following:
<DL>
<DT><B>default</B>
<DD> The default setting is equivalent to all the other
options (<B>align</B>, <B>limit</B>, <B>redirect</B>,
and <B>none</B>) being disabled.
<DT><B>align</B>
<DD> Generate warnings during a "<B>cif see</B>" command
if the alignment of geometry is on fractional lambda.
Normally, magic allows contacts to be drawn at
half-lambda positions. If this violates DRC requirements
for the minimum output grid, this warning setting can be
used to detect such violations.
<DT><B>limit</B>
<DD> Limit warnings to the first 100 warnings or errors only.
<DT><B>redirect</B> [<I>file</I>]
<DD> Redirect all warnings to an output file named <I>file</I>.
If <I>file</I> is not given, then redirection is disabled.
<DT><B>none</B>
<DD> Do not produce any warning messages on GDS input.
</DL>
<DT> <B>write</B> <I>file</I>
<DD> Output GDSII format to "<I>file</I>" for the window's root cell.
<DT> <B>polygon subcells</B> [<B>yes</B>|<B>no</B>]
<DD> Put non-Manhattan polygons into subcells. Default is "no".
Normally this option is not needed. However, input layout
that defines a number of angled wires, particularly those
that are closely spaced, can cause <B>magic</B> to generate
literally millions of internal tiles. This tends to be
true in particular for corner cells in padframes for deep
submicron feature sizes, where the angled corners are
required to meet the DRC specification. When set to "yes",
each polygon encountered in the GDS input is placed in its
own uniquely-named subcell. This prevents interations with
other polygons on the same plane and so reduces tile splitting.
</DL>
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>gds</B> command reads or produces GDSII output (also known as
"stream" output, or "calma" output after the name of the company
that invented the format), or sets various parameters affecting
the GDS input and output. In magic, the GDS read and write routines
are a subset of the CIF read and write routines, and so it is
important to note that certain <B>cif</B> command options (q.v.) also
affect GDS input and output. In particular, <B>cif istyle</B> and
<B>cif ostyle</B> set the input and output styles from the technology
file, respectively. <P>
If no option is given, a CALMA GDS-II stream file is produced for the
root cell, with the default name of the root cell definition and the
filename extension ".gds". <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>gds</B> is implemented as a built-in function in <B>magic</B>.
The <B>calma</B> command is an alias for <B>gds</B> and is
exactly equivalent.
</BLOCKQUOTE>
<H3>Bugs:</H3>
<BLOCKQUOTE>
<UL>
<LI> The <B>cif</B> command options that affect GDS input and output
should <I>really</I> be duplicates as options of the GDS command.
<LI> GDS input is "interpreted" through boolean operations in the
technology file definition, and so it is not guaranteed that
all input will be read correctly.
<LI> Not all non-Manhattan geometry is read correctly.
<LI> The input can be fouled up if the magic grid is rescaled during
input. This error can be avoided by scaling the grid prior
to GDS read-in.
<LI> "polygon subcells" in GDS creates a duplicate image of the
layout read into the subcells; this needs to be fixed.
</UL>
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=cif.html><B>cif</B></A> <BR>
</BLOCKQUOTE>
<P><IMG SRC=graphics/line1.gif><P>
<TABLE BORDER=0>
<TR>
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 4, 2005 at 3:17pm <P>
</BODY>
</HTML>
|