University of California at Berkeley
           Department of Electrical Engineering & Computer Sciences
                   Instructional $ Electronics Support Group


/share/b/pub/magic.help
/share/b/pub/flea.help


  ***********************************************************************
	   This software is no longer available here. (July 2004)

      See http://inst.eecs.berkeley.edu/cgi-bin/clients.cgi?choice=13
             for a list of other Instructional login servers.

               See http://inst.eecs.berkeley.edu/software.html
      for reference to software that is available on the other servers.
   ***********************************************************************

						  	         Apr 30, 1999
CONTENTS
	Where to find 'magic'
	On-Line Manual Pages
	Using 'magic' with X Windows
	Printing 'magic' files with 'flea'


Where to find 'magic'
--------------------
  Magic is software developed by the Berkeley CAD Group. 
  Magic can be obtained via anonymous ftp to gatekeeper.dec.com.  It
  is also available in a bundled package (docs, files on tape) for a
  nominal charge from UCB ILP Software Distribution, 510-643-6687.

  Magic is available on the EECS Instructional DEC systems by the full
  pathname /cad/bin/magic.  There is a version for the DEC mips (Ultrix)
  and DEC Alpha (OSF1) systems.  It can be run on the DEC workstations 
  in 119 and 199 Cory.

  To run magic you can type just 'magic'.  If you get "command not found",
  try it by the full path name '/share/b/bin/magic'.    You can add that
  directory to your UNIX search path by typing:

     set path = (/share/b/bin $path); rehash

  You can modify your path setting in your .login or .cshrc file to
  set this automatically when you login in the future.

On-Line Manual Pages
--------------------
  The current version of Magic is in /share/b/cad/cs250/src/magic-6.4.4.
  Documentation is under /share/b/cad/man.  You can add that to your UNIX 
  manual page search path using the command:

    setenv MANPATH ${MANPATH}:/share/b/cad/man

  You can read the manual pages with these UNIX commands:

    man 1 magic
    man 5 magic
    man 1 flea

    man 1 ext2sim fsleeper magicusage sim2spice ext2spice 
    man 1 grsunprog net2ir sleeper ext2dlys extcheck rsleeper
    man 3 geometry list path stack hash magicutils runstats string
    man 3 dqueue heap malloc set extflat libmalloc mpack show
    man 5 cmap dlys ext sim displays dstyle glyphs net
    man 8 prleak

Using 'magic' with X Windows
----------------------------
  If you log into an EECS Instructional DEC workstation, you can run magic 
  by typing 

     magic -d XWIND my_layout.mag

  The "-d XWIND" command line option tells magic to use X Windows.

  To run magic on a remote system and display it on a local workstation,
  follow these steps.  (for example, sitting in front of a workstation
  called "duke.eecs" and running magic on "cory.eecs"):

  1) Login at the "duke.eecs" workstation console.
  2) In the window that pops up, type:
     xhost +cory.eecs
     rlogin cory.eecs
  3) Once logged into cory.eecs, type:
     setenv DISPLAY duke.eecs:0.0
     magic -d XWIND my_layout.mag

  The "xhost" command tells the workstation that it is OK for your program 
  on cory.eecs to open a window, and the "setenv DISPLAY" command tells 
  cory.eecs where to send the window.


Printing 'magic' files with 'flea'
----------------------------------
  'flea' converts magic outpout files to Postscript format.  The Postscript 
  files can be viewed on-screen using "ghostview" or printed to a Postscript 
  printer using "lpr" or "lp".   For access to the on-line manual page:

    setenv MANPATH ${MANPATH}:/share/b/cad/man
    man 1 flea

  'flea' is available on volga.eecs (DEC Ultrix)( for Instructional users.   
  (Nov 1998) FLEA has also been compiled for HP-UX and OSF1 (199 & 117 Cory).

    source in /share/b/cad/flea/src
    libraries in /share/b/cad/flea/lib
    binaries in /share/b/cad/bin/{OSF1,HP-UX}/flea

  Information about the build is in /share/b/cad/flea/src/README.INST

  See http://infopad.eecs.berkeley.edu/~icdesign/tools.html for more about 
  the Magic and flea programs.
 

                                  		EECS Instructional Support
				  		378/284/386 Cory, 333 Soda
				  		inst@eecs.berkeley.edu