researchv9/jtools/README - annotate

Return to README CVS log

Up to [Research Unix] / researchv9 / jtools

Annotation of researchv9/jtools/README, revision 1.1.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

unix.superglobalmegacorp.com

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