DragonFly On-Line Manual Pages

Search: Section:  

FH(1)                  DragonFly General Commands Manual                 FH(1)


NAME

       fh - Road map generator for GDSII/CIF/MAGIC/PCSTR/VALID formats


SYNOPSIS

       fh [ -ADhIRSTX ] [ -cCIFfilename | -gGDSIIfilename | -m | -p |
       -vValid_WRK_filename ] [ -finputCommandFIle ] [ -n [f|n|r] ] [
       -ooutputFilename ]


DESCRIPTION

       fh 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
       conflict 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 commands for consistency. Pager mode is included(Unix only).  You
       can toggle 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
              supercells of the subcell are listed. Useful for dependency
              management.

       -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
              schematics.

       -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
       Interactive 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 ALSO

       cjen(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)

Search: Section: