Return to README CVS log

Up to [Research Unix] / researchv9 / jtools

Annotation of researchv9/jtools/README, revision 1.1

1.1     ! root        1: This directory contains some tools which run under X11 and Sunview
        !             2: which are derived from the 9th Edition 5620 tools.  Manual pages for
        !             3: the tools are in man/man1.  See jtools.1 for an overview.
        !             4: 
        !             5: To use them, just put /usr/jtools/bin in your PATH.  If you are planning
        !             6: to use pi on a Sun system running SunOS release 3.5 or earlier, the above
        !             7: directory should be before /usr/ucb in your PATH as there is a pi
        !             8: (Pascal Interpretor) there.
        !             9: The files in /usr/jtools/bin are all links to the same shell file.
        !            10: This file attempts to figure out which window system is running
        !            11: and determine the architecture of the machine to select the
        !            12: appropriate binaries.   To install the directory somewhere else
        !            13: it will only be necessary to edit the DIR= line in the bin shell file.
        !            14: 
        !            15: Some of the programs (pi and sysmon) read kernel memory.  In SunOS
        !            16: release 4.0 this access is restricted to the group kmem.  For these
        !            17: programs to work correctly, the following must be done by a super-user
        !            18: of the system:
        !            19:        chdir /usr/jtools/xxbin;
        !            20:        chgrp kmem pi sysmon;
        !            21:        chmod 2755 pi sysmon;
        !            22: where xx is either s2,s3,s4,x3, or x4 dedending on the machine architecture
        !            23: and window system used. This does not need to be done for SunOS releases 3.5
        !            24: and earlier.  If the permissions are not changed on 4.0 releases, sysmon
        !            25: won't work and pi will not allow examination of kernel data structures.
        !            26: 
        !            27: A list of the subdirectories (some of which may be missing)
        !            28: and their contents is shown below:
        !            29: 
        !            30:        man:            Man pages
        !            31:        doc:            Documentation (TMs)
        !            32:        src:            Source code for tools and 5620 emulator library
        !            33:        lib:            Emulator libraries
        !            34:        include:        Include files for emulator library
        !            35:        bin:            Common bin (a single shell file with multiple links)
        !            36:        s2bin           sun-2 sunview binaries
        !            37:        s3bin           sun-3 sunview binaries
        !            38:        s4bin           sun-4 sunview binaries
        !            39:        x3bin           sun-3 X11 binaries
        !            40:        x4bin           sun-4 X11 binaries
        !            41: 
        !            42: A list of the currently ported tools (in bin) is given below:
        !            43: 
        !            44:        Jpic -  parses pic input for cip. Not called directly by the user.
        !            45: 
        !            46:        blitblt - Interactive screen dumping program.  Output files
        !            47:                are in Ninth Edition bitfile format and can be converted
        !            48:                to PostScript and other printer languages using filters.
        !            49:                This program ONLY works with monochrome displays.
        !            50: 
        !            51:        cip -   Drawing program which generates pic output.
        !            52: 
        !            53:        cleave - Separates C++ header files into private and public parts
        !            54:                for efficiency in big applications.  Used to generate pi.
        !            55: 
        !            56:        hang -  Used to stop a process before it executes the first instruction
        !            57:                so pi can attach to it.  Useful when you don't want to start
        !            58:                the process from pi (if started from pi, it redirects the
        !            59:                standard input and output to /dev/null).  Don't use this
        !            60:                with dbx unless you are willing to reboot your machine
        !            61:                with SunOS releases 3.5 and earlier.
        !            62: 
        !            63:        icon -  Icon editor.
        !            64: 
        !            65:        pads -  Terminal half of pi. Not called directly by the user.
        !            66: 
        !            67:        pi -    Tom Cargills process inspector: a window based debugger
        !            68:                with a very nice user interface.  Currently not available
        !            69:                for Sun 4's.
        !            70: 
        !            71:        rtpi -  Real-time pi.  Used to remotely debug real-time processors
        !            72:                over Ethernet.
        !            73: 
        !            74:        sam -   A mouse/screen editor with a powerful command language
        !            75:                written by Rob Pike.
        !            76: 
        !            77:        sux -   an interactive terminal program which emulates the
        !            78:                terminal interface provided by mux terminal windows.
        !            79:                Text can be edited anywhere on the screen using an
        !            80:                interface which is very similar to sam.
        !            81: 
        !            82:        sysmon - Bar style load monitor.  Looks best when it is
        !            83:                long and skinny.
        !            84: 
        !            85:        tek -   Tektronix 4014 emulator
        !            86: 
        !            87:        xsamterm - Terminal process for sam. Not called directly by the user.
        !            88: 
        !            89:        Games:
        !            90:                asteroids - Use mouse buttons to control.
        !            91:                life -  Use left and middle mouse button to control.
        !            92:                pacman - Instructions on startup.
        !            93:                swar -  Use asdwx and kl;o. keys to control.
        !            94:                The games don't work very well with X11.
        !            95: 
        !            96: Feel free to give the binaries to other AT&T employees.
        !            97: However, I would appreciate if you would send me the names of people
        !            98: who receive it, so I can notify them when bugs are fixed.
        !            99: 
        !           100: If you have any problems, please contact me (email preferably).
        !           101: 
        !           102:        Dave Kapilow
        !           103:        alice!dak
        !           104:        (201) - 582 - 3596
        !           105:        MH 2B-424

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.