DBLIST(1ICD)

NAME
dblist - list cells in the database

SYNOPSIS
dblist [-lcf] [-d] [-hi] [-rst] [cell]

OPTIONS

-l  List only cells of the layout view.

-c  List only cells of the circuit view.

-f  List only cells of the floorplan view.

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

-h  Make a hierarchical listing.

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

-r  List only the roots in a hierarchical listing.

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

-t  Total expansion always for each cell in a hierarchical listing.

DESCRIPTION
Dblist 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.

EXAMPLES
The first example lists all cells that are present in a database:
% dblist
layout:
feedback	mod2_fb	sel_reg8
latch	rand_cnt	select
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, 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 'function'.

AUTHOR
S. de Graaf

FILES
proj_dir/view/celllist	(input file)
proj_dir/view/cell/mc	(input file)
proj_dir/circuit/cell/fterm	(input file)