FH(1)FH(1)NAMEfh - Road map generator for GDSII/CIF/MAGIC/PCSTR/VALID formats
SYNOPSISfh [ -ADhIRSTX ] [ -cCIFfilename | -gGDSIIfilename | -m | -p |
-vValid_WRK_filename ] [ -finputCommandFIle ] [ -n [f|n|r] ] [ -oout‐
putFilename ]
DESCRIPTIONfh is a road-map generator for MAGIC/CIF/GDSII/PCSTR/VALID formats.
When you have a large number of layout/schematic files or cells which
have possibly many top cells drawn by other people, how can you manage
them ? fh is written for that situation. It can be very useful by your
imagination or Unix skill.
OPTIONS
Upper and lower case are not equivalent. For the user of version 1.12
or before, since there are some changes in options from version 1.13,
if you made some shell scripts based on this tool, read this carefully
and modify it properly. Since from version 1.13 since I found a con‐
flict in option -i, I changed all the command options such as adilrstx
which make the tool as command line use, are changed to upper case com‐
mands for consistency. Pager mode is included(Unix only). You can tog‐
gle the mode with interactive command 'p'.
The basic switches are:
-A List all possible top cells, i.e., the cells which were not
called by any other cells.
-cCIFfilename
CIF input format. MAGIC extensions are supported.
-D Lists dangling cells. Dangling cells are the cells referenced
but not found.
-finputCommandFile
Specify input command file. You can use all the interactive mode
command in the file. If command file is finished, the command
interpreter changes the input to the default, standard input
stream. So if you want to terminate fhautomatically, you should
use 'q' command at the end of the input command file.
-gGDSIIfilename
GDSII input format. no CR/LF.
-h Help message
-I Lists included cells(should specify a top cell at the end of the
option list). For PCSTR and MAGIC format which use separate
file per each cell, FH attaches the proper extension that each
CAD tool uses. So this option is useful for tar, mv, cp, etc.
-i is an ignore-case option for cell names. It doesn't make the
tool ignore the cases in file names. But only in cell name
matching, it doesn't care about the case when the option is
issued. You can not change this option in the interactive mode.
I am not sure if it will be useful.
-m MAGIC input format. default.
-n 'f|n|r'
changes the number option. forward|nonumber|reverse
-ooutputFilename
Specify output file name. In interactive mode, you can specify
output stream as well.
-p PCSTR format.
-R Tree retracing option. For the specified subcell, all the super‐
cells of the subcell are listed. Useful for dependency manage‐
ment.
-S Summary. For possible top cells, the trees are displayed. The
most probable top cell is suggested. Dangling cells, and unused
cells are also displayed.
-T List possible TOP cells, i.e., the cells which have the deepest
tree structure.
-v VALID.wrk
analyses the SCALD workfile named "VALID.wrk" for GED schemat‐
ics.
-X List excluded cells(should specify top cell at the end of option
list). Exactly complementary to -I option. Useful for mv, rm,
etc
Interactive mode commands are basically the same with its corresponding
switches except for the Input/output file control commands. In Interac‐
tive mode, Input file control command is '<', output control command is
'>' which are not easy to use in shell command mode.
EXAMPLES
Reads GDSII file foo.strm and enter into interactive mode:
fh-g foo.strm
Reads CIF file foo.cif and list all the subcells of footop:
fh-c foo.cif -I footop
Tar-gzip-cjen all the subcells of mytop.str:
tar cvf - `fh -pI mytop` | gzip -c | cjen mytop.tar.gz > myt.cj
SEE ALSOcjen(1c), cjde(1c)
README
AUTHOR
Gyudong Kim
BUGS
No body knows where all the bugs are yet. Not all variants of CIF file
format are supported. For improper combination of options, or for
improper input files, nobody can predict the behaviour. On a slow
machine, it works very slowly although I put every effort to make it
fast. (for tree construction, it never calls any strcmp.)
Bug REPORT
chilly@eltn20.snu.ac.kr
10 March 1995 FH(1)