


DBLIST(1ICD)		     1/10/86		     DBLIST(1ICD)



NNNNAAAAMMMMEEEE
     dblist - list cells in the database

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     ddddbbbblllliiiisssstttt [-lcf] [-d] [-hi] [-rst] [cell]

OOOOPPPPTTTTIIIIOOOONNNNSSSS
     ----llll      List only cells of the layout view.

     ----cccc      List only cells of the circuit view.

     ----ffff      List only cells of the floorplan view.

     ----dddd      List also device cell calls (and functions in the
	     circuit view).

     ----hhhh      Make a hierarchical listing.

     ----iiii      List also imported root cells in a hierarchical
	     listing.

     ----rrrr      List only the roots in a hierarchical listing.

     ----ssss      Start expansion for each cell again for new roots in
	     a hierarchical listing.

     ----tttt      Total expansion always for each cell in a hierarchi-
	     cal listing.

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     _D_b_l_i_s_t is a program that makes a listing of the cells that
     are present in the IC design database.

     When the option -h is specified, a hierarchical listing of
     the cells will be shown.  In this situation, a cell can be
     specified for which its tree is shown.  When no cell is
     specified, a listing of all cell trees is made.

     When the option -h is not specified, a cell name or regular
     expression ('?', '*' or '[]') may be specified and only the
     matching cell names are listed.

EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
     The first example lists all cells that are present in a
     database:

     % dblist

     layout:
     feedback	     mod2_fb	     sel_reg8
     latch	     rand_cnt	     select




		   The Nelsis IC Design System			1






DBLIST(1ICD)		     1/10/86		     DBLIST(1ICD)



     circuit:
     feedback	     mod2_fb	     rand_cnt	     select
     latch	     multplex	     sel_reg8	     total
     imported:
     Xlatch	     Xselect

     floorplan:
     <no cells>

     The second example lists only the cells of the layout view:

     % dblist -l
     feedback	     mod2_fb	     sel_reg8
     latch	     rand_cnt	     select

     The third example lists only the cells of the layout view,
     which begin with the letter 's':

     % dblist -l 's*'
     sel_reg8	     select

     The fourth example lists only the cells of the layout view,
     but in a single column if stdout is redirected:

     % dblist -l | cat -n
	  1  feedback
	  2  latch
	  3  mod2_fb
	  4  rand_cnt
	  5  sel_reg8
	  6  select

     The fifth example lists the cell tree of cell "rand_cnt" for
     the layout view:

     % dblist -lh rand_cnt
     1 - rand_cnt	(2)
	 2 - sel_reg8	      1 (2)
	     3 - latch		  8 (0)
	     3 - select 	  8 (0)
	 2 - feedback	      1 (3)
	     3 - mod2_fb	  3 (0)

     The first number on a line is the level of the corresponding
     cell in the cell tree.  The second number (if present) is
     the total number of times (incl. copies) the cell is used,
     and the third or last number (between parenthesis) is the
     number of sub cells.  For example, cell "sel_reg8" is on
     level 2, it is used 1 time by "rand_cnt", and it has 2 sub
     cells.  One of the sub cells is "latch", which is used 8
     times by "sel_reg8", and which has no sub cells itself.  (It
     is a leaf cell).  Because "sel_reg8" has only 2 sub cells,



2		   The Nelsis IC Design System






DBLIST(1ICD)		     1/10/86		     DBLIST(1ICD)



     there must have been used a cell copy statement (array
     specification) to get 8 "latch" cells.

     For the circuit view, the third or last number (between
     parenthesis) counts also the device cell calls.  When a cell
     call is a call to a function block (if file "fterm" exists)
     the third number for this cell will be replaced by 'func-
     tion'.

AAAAUUUUTTTTHHHHOOOORRRR
     S. de Graaf

FFFFIIIILLLLEEEESSSS
     proj_dir/_v_i_e_w/celllist		(input file)
     proj_dir/_v_i_e_w/_c_e_l_l/mc		(input file)
     proj_dir/circuit/_c_e_l_l/fterm	(input file)







































		   The Nelsis IC Design System			3



