NAME

       net - format of .net files read/written by Magic's netlist editor

DESCRIPTION

       Netlist  files  are  read  and  written  by  Magic's netlist editor in a very simple ASCII
       format.  The first line contains the characters ``  Netlist File'' (the leading  blank  is
       important).   After that comes a blank line and then the descriptions of one or more nets.
       Each net contains one or more lines, where each line contains a single terminal name.  The
       nets  are  separated  by  blank lines.  Any line that is blank or whose first character is
       blank is considered to be a separator line and the rest of its contents are ignored.

       Each terminal name is a path, much like a file path name in Unix.  It consists of  one  or
       more  fields separated by slashes.  The last field in the path is the name of a label in a
       cell.  The other fields (if any), are cell instance identifiers that form a path from  the
       edit  cell  down  to  the label.  The first instance identifier must name a subcell of the
       edit cell, the second must be a subcell of the first, and so on.

       Instance identifiers are unique within their parent cells, so a terminal  path  selects  a
       unique  cell  to  contain  the  label.   However, the same label may appear multiple times
       within its cell.  When this occurs, Magic  assumes  that  the  identical  labels  identify
       electrically equivalent terminals; it will choose the closest of them when routing to that
       terminal.  Further, after connecting to one of these terminals Magic may take advantage of
       the  internal  wiring  connecting  them  together and route through a cell to complete the
       net's wiring.

       An example netlist file follows below.  It contains three distinct nets.

       ———————————————————————————————————————
               Netlist File

              alu/bit_1/cout
              alu/bit_2/cin

              regcell[21,2]/output
              latch[2]/input
               This line starts with a blank, so it's a separator.
              opcode_pla/out6
              shifter/drivers/shift2
       ———————————————————————————————————————

SEE ALSO

       magic(1)