xref: /minix3/external/bsd/top/dist/INSTALL (revision b89261ba018da33f0bd8cd05f5a1fe9e7a9c837b)
1*b89261baSDavid van Moolenbroek                             TOP
2*b89261baSDavid van Moolenbroek                       Version 3.8beta1
3*b89261baSDavid van Moolenbroek
4*b89261baSDavid van Moolenbroek                       William LeFebvre
5*b89261baSDavid van Moolenbroek		      and a cast of many
6*b89261baSDavid van Moolenbroek
7*b89261baSDavid van MoolenbroekINSTALLATION
8*b89261baSDavid van Moolenbroek
9*b89261baSDavid van MoolenbroekConfiguration and installation of top is easy.  Top version 3.6
10*b89261baSDavid van Moolenbroekcomes with a configure script generated by gnu autoconf.  After
11*b89261baSDavid van Moolenbroekunpacking the tar file, simply run "./configure".  The script will
12*b89261baSDavid van Moolenbroekautomatically perform a series of checks on the system and determine
13*b89261baSDavid van Moolenbroekwhat settings are appropriate for the Makefile and certain include
14*b89261baSDavid van Moolenbroekfiles.  Once configure completes, simply type "make install" and
15*b89261baSDavid van Moolenbroektop will be compiled and installed.  By default, the installation
16*b89261baSDavid van Moolenbroeklocation is /usr/local/bin.  You can change the destination location
17*b89261baSDavid van Moolenbroekwith the --prefix option to configure.
18*b89261baSDavid van Moolenbroek
19*b89261baSDavid van MoolenbroekIn addition to the standard options, top's configure script supports
20*b89261baSDavid van Moolenbroekthe following:
21*b89261baSDavid van Moolenbroek
22*b89261baSDavid van Moolenbroek    --with-module=name
23*b89261baSDavid van Moolenbroek
24*b89261baSDavid van Moolenbroek	Force the use of a particular module.  Modules are located
25*b89261baSDavid van Moolenbroek	in the subdirectory "machine".  A module's name is derived
26*b89261baSDavid van Moolenbroek	from the file's basename without the leading "m_".
27*b89261baSDavid van Moolenbroek
28*b89261baSDavid van Moolenbroek    --with-ext=name
29*b89261baSDavid van Moolenbroek
30*b89261baSDavid van Moolenbroek	Compile with the extension "name", found in the subdirectory
31*b89261baSDavid van Moolenbroek	"ext". At the present time, there are no extensions in the
32*b89261baSDavid van Moolenbroek	standard distribution.
33*b89261baSDavid van Moolenbroek
34*b89261baSDavid van Moolenbroek    --enable-debug
35*b89261baSDavid van Moolenbroek    --disable-debug
36*b89261baSDavid van Moolenbroek
37*b89261baSDavid van Moolenbroek	Default off. Include debugging output in the compilation,
38*b89261baSDavid van Moolenbroek	which can be seen with the -D switch.
39*b89261baSDavid van Moolenbroek
40*b89261baSDavid van Moolenbroek    --enable-color
41*b89261baSDavid van Moolenbroek    --disable-color
42*b89261baSDavid van Moolenbroek
43*b89261baSDavid van Moolenbroek	Default on.  Include code that allows for the use of color
44*b89261baSDavid van Moolenbroek	in the output display.  Use --disable-color if you do not
45*b89261baSDavid van Moolenbroek	want this feature compiled in to the code.  The configure
46*b89261baSDavid van Moolenbroek	script also recognizes the spelling "colour".
47*b89261baSDavid van Moolenbroek
48*b89261baSDavid van Moolenbroek    --enable-kill
49*b89261baSDavid van Moolenbroek    --disable-kill
50*b89261baSDavid van Moolenbroek
51*b89261baSDavid van Moolenbroek	Default on.  Include code that allows for renicing and sending
52*b89261baSDavid van Moolenbroek	signals to processes from within top (the 'kill' and 'renice'
53*b89261baSDavid van Moolenbroek	commands). Use --disable-kill if you do not want this feature
54*b89261baSDavid van Moolenbroek	compiled in to the code.
55