Training courses

Kernel and Embedded Linux

Bootlin training courses

Embedded Linux, kernel,
Yocto Project, Buildroot, real-time,
graphics, boot time, debugging...

Bootlin logo

Elixir Cross Referencer

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
Tue May  6 2008 - wnl (3.8beta1)
	Main code: fixed bugs in screen_cleareol and in display code. Fixed
	bug in i_swap when all data is 0.  Added ^W patch (from thaquis).
	Fixed bug in xdprintf.  Added command line options for the "t" and
	"m" commands.
	SunOS 5 changes:  Support for showing individual threads.  Redid
	allocation of prpsinfo structures.  Added a pidthr hash that uses
	both pid and thread id for a key. Changed format_process_header
	and format_next_process to use a table-driven method for generating
	the columns.  Status files from /proc (psinfo and lpsinfo) are now
	cached to avoid repeatedly reopening them.  Column showing number of
	LWPs is now called "NLWP" and column showing lwpid is "LWP".
	FreeBSD changes: Runtime check to ensure binary is running on
	the same machine type it was compiled for.  Lots of cleanup and
	changed nearly everything to use sysctl rather than kvm, and
	inability to open kvm is no longer fatal. Improved thread reporting:
	disabled for 7.x and lower.  Added lwpid hash for proper tracking
	of threads.  Changed format_process_header and format_next_process
	to use a table-driven method for generating the columns.
	Dec Alpha: configure uses compile-time options to properly trap
	and handle exceptions from the Alpha FPU (from Brian Maly).

Tue Feb 26 2008 - wnl (3.7)
	Prepare for version 3.7 release.

Fri Feb  1 2008 - wnl (3.7beta4)
	Using the $ notation in printf formats for freebsd apparently was
	causing problems on 64-bit systems. All such usage has been
	removed and the process line is formatted piecemeal.

Thu Dec 27 2007 - wnl (3.7beta3)
	Improved function comments in display.c for message_error functions.
	Changed some of the error messages in top.c to be more succint.

Fri Dec  7 2007 - wnl (3.7beta3)
	Changes to freebsd port: moved some functions up front to
	eliminate forward references. Use sysctl to get all vm stats
	information, as some of this isn't updated in the struct
	vmmeter under FreeBSD 7.0.  Added routines to support large-scale
	sysctl access.

Wed Nov 28 2007 - wnl (3.7beta3)
	Changes to documentation: FAQ, README, man page.

Tue Nov 27 2007 - wnl (3.7beta3)
	For freebsd, added page faults, pageins, pageouts, and pages
	freed to the kernel display line.  These numbers reflect the
	values presented in vmstat.  For sunos5, added page faults,
	pageins and pageouts to the kernel display line.

Fri Nov  2 2007 - wnl (3.7beta3)
	Added copyright notices to the top of every source and include file.
	Added copyright information to the man page.
	Removed a few outdated things from the manifest.
	Minor changes to sigconv.awk. 

Sat Oct 27 2007 - wnl (3.7beta3)
	Added check for sys_signame at configure time and if it is
	present then it is used in commands.c to translate signal names
	in to numbers.
	Added alternate snprintf and vsnprintf functions from apache (in
	ap_snprintf.c).  Added configure magic to define and compile them in
	where needed.  Added check to configure for variadic macros.
	Preprocessor defintion of dprintf (in utils.h) now depends on
	support for variadic macros.  Cleaned up m_linux code.

Wed Oct  3 2007 - wnl (3.7beta3)
	Lots of changes, thanks to Mark Wong.  Most changes were to
	clean the code up so that it would compile cleanly with -Wall
	(all warnings).  Changed function names in screen.c so that
	they all start with "screen_".  Isolated all interaction with
	termcap to screen.c by adding a real function for cursor
	addressing (in the past it was just a macro).  Only screen.c
	now needs to worry about defining templates for the termcap
	functions.  Added configure and preprocessor magic to ensure
	that all the termcap functions used in the code are defined
	with templates.  Changed names of some other functions and
	global variables to avoid name conflicts with functions in
	curses and other well established libraries.  Changed dprintf
	macro to use variadic arguments so that the preprocessor can
	gobble up the entire call when compiling without debugging
	(this will have to be made more portable). All include files
	are surrounded by #ifndef statements to accomodate multiple
	inclusions.  Platform module is now compiled with
	-fno-strict-aliasing as some of the modules do type punning
	that can confuse the optimizer.

Wed Sep 26 2007 - wnl (3.7beta3)
	For freebsd, priority is no longer normalized by PZERO.  This
	contradicts the behavior used by ps when it displays priority.
	But normalizing by PZERO has become a bit of an anachronism
	and it actually obscures the meaning of the priority without
	adding any real value.

Wed Sep 19 2007 - wnl (3.7beta3)
	Many changes to improve the display of threads.  Changed
	process summary line to use the word "threads" when showing
	individual threads.  Added the system command to toggle the
	display of system processes.  Fixed bug in hash.c remove_pos.
	For freebsd: count threads correctly when they are being
	displayed, nice column is more closely in line with ps
	(nothing fancy for real time processes), add two more process
	states that didn't exist in older releases of freebsd (wait
	and lock).
	For linux: Threads done right.  Now track individual threads
	of multi-threaded processes separately so that we always know
	their %cpu.  Switch to format_process_header so that we can
	change the column headings and remove the THR column when
	displaying individual threads.  Switched process (and thread)
	tracking over to use generic hash table functions included
	with the new version of top.  Process states and total now
	include threads when they are being shown. Added "SHR" column
	to show the amount of shared memory per process. Improved
	calculation of elapsed time and percent cpu to avoid
	overflows. Remove weighted cpu calculations entirely as it is
	an anachronism.
	For Solaris: Moved check for libelf to accomodate older systems.
	
Sun Sep  9 2007 - wnl (3.7beta2)
	Documentation changes.  Fixes to sunos5 port.  Added display of
	thread count and selection by command name to linux port.  Removed
	the use of inline functions from hash.c as that doesn't appear to
	be very portable.

Wed Sep  5 2007 - wnl (3.7beta1)
	Fixed freebsd and linux configuration bugs.  Added configuration
	options for tweaking program defaults.  Rewrote top level code
	(top.c) from scratch, including command handling so that adding
	new commands is much easier.  Changed message-line handling to
	ensure that the message is displayed for at least 5 seconds
	regardless of the update frequency.  Added a "miniupdate" that
	occurs one second after the initial screen on systems that don't
	already delay the first screen.  The mini-update shows cpu state
	percentages.  Added ability to select output by command name on
	some systems.  Fixed color toggling via the "C" command.  Added
	long options via getopt_long to complement the existing single
	character options.  Added the freebsd "m" command to chose
	alternate display modes.  On freebsd this gives a process i/o
	display.  Added the freebsd "H" command to select the display of
	individual threads.  Added "-a" option ("all") to set number of
	displays and number of processes to infinity (equivalent to
	"-d all all").  Added dual architecture compilation for Solaris
	to generate both a 32-bit and a 64-bit binary.  This is on by
	default when compiling on a 64-bit system and can be explicitly
	set via "configure --enable-dualarch".  Added uniform hashing
	functions that use bucket hash for uint, pid, and string.  Changed
	username.c and the sunos and freebsd modules to use these functions.
	Added the "kernel" information line to the display to show
	statistics on what the kernel is doing (context switches, forks, 
	traps, etc.).  This requires explicit support by the platform
	module, currently only freebsd, linux, and sunos.

Wed Apr 18 2007 - wnl (3.6.1)
	Fixed a few bugs in sigconv.awk that were causing incorrect
	results on FreeBSD.  Changed configure.ac to fix a few linux
	problems: signal include file and /proc/1/stat.

Fri Apr 13 2007 - wnl (3.6.1)
	Removed the use of VPATH for compiling the system module and used
	an explicit dependency in the Makefile instead.  VPATH is now set
	to just srcdir to ensure that top will compile correctly when
	configured from a different directory.  On systems without VPATH
	support, top will still configure and compile, but only
	from within the source directory.  This fixes bug 1699526.

Fri Feb  2 2007 - wnl (3.6.1)
	Revised the way that configure figures out owner, group, and mode.
	For systems that don't use the kernel, it tries to match install
	settings to allow access to stuff in /proc.  More importantly, if
	mode is 755 then neither owner nor group are set.  This fixes bug
	1631136.  Added patch from haanjdj@xs4all.nl to fix an occasional
	core dump in m_decosf1.c.  This checks return code from task_threads.
	Made sure all get_system_info functions are declared void.  Fixed
	string termination bug.  Cleaned up documetation for sunos5.

Tue Aug  8 2006 - wnl (3.6.1)
	For Solaris, changed the tag "swap" to "total swap" to clarify
	what is beign displayed.  Note that the calculations are still the
	same: the display is just showing total rather than total - free.

Thu Apr 27 2006 - wnl (3.6)
	Added patches for linux-style sort shortcuts and for Unixware
	support in configure (patch 1474427).  Fixed sunos5 to do slow start
	and to ensure cpucount is set (patch 1477386).  Added pagination
	routines to display.c and modified show_help to use it, since the
	help screen is now longer than 24 lines.  Applied patch for unixware
	support that adds check for mas library (patch #1474423).  Solaris
	cpu percent now reflects a percentage of the entire server, rather
	than a single cpu (bug 1478138).

Mon Mar 27 2006 - wnl (3.6)
	The production release of version 3.6.  Fixed a minor scaling
	bug in the decosf1 module.  Support for MacOS X is officially
	withdrawn although the macosx module is still part of the
	distribution.  Hopefully this is a temporary situation.
	Documentation updated.


Wed Feb 15 2006 - wnl (3.6beta5)
	Minor changes to eliminate warnings from the Sun Studio compiler.
	These were mostly sloppy argument declarations.  I also added
	message.h to provide an interface file for just the message
	related functions of display.c.

Mon Dec 26 2005 - wnl (3.6beta4)
	Added new netbsd module, courtesy of Simon Burge.
	Fixed a few bugs in SVR4 module and added its use to
	configure.ac, thanks to Sanchet Dighe.  Also ensured that the
	novpath Makefile was in the distribution.
	Fixed portability problem in display.c


Mon Oct 24 2005 - wnl (3.6beta3)
	Set up a color tagging mechanism in color.c to allow for the
	dynamic creation of tag names to contol color highlighting.
	These names are partially derived from the tags used to label
	memory and swap information on the screen, thus are driven by
	the machine module itself.  Added -T option to list color 
	highlighting information.  Help screen now includes the actual
	list of sort order names.  Incorporated some minor fixes to
	the main code from the Freebsd source tree.  Fixed bug #1324582.
	Freebsd 5: removed WCPU column and added THR column.  Display
	for freebsd 4 and earlier unchanged since they don't track
	threads in the kernel.  Added LICENSE file to distribution.

Wed Oct 12 2005 - wnl (3.6beta2)
	Major overhaul to display.c.  All lines of the display are
	directly tracked and controlled via display_write and its
	companion display_fmt.  Added support for complete control
	of ANSI color on the screen: this will be used in the future
	to allow for full use of color everywhere on the screen.
	Signal handling code now uses sigaction on all systems that
	support it.  Restored the freebsd module and did away with
	freebsd4, and upgraded freebsd module to support 5.x.
	Fix bug #1306099 (wio(wait) timer ignored on OSF1).

Fri Sep 23 2005 - wnl (3.6beta1)
	Fixed bugs #1266341 (compilation errors with gcc 4.x),
	#1156464 (cpu% field for sunos), #1156243 (compilation
	errors on AIX).  Applied patches #1217855 (Solaris 10
	xarch flag).  Overhaul of sunos5 module, making code more
	efficient and easier to follow.  Got rid of need for MEMTYPE
	type in utils.h.  Changed all memory statistics data in the
	module specification from an int to a long to better support
	64-bit systems with lots of memory. Moved all unused modules
	out of the distribution (I will add them back in as needed).
	Moved freebsd module to freebsd4 as it won't work with 5.x
	(a new module will be necessary). Added support to configure
	for makes that don't understand VPATH. Updated documentation:
	man page, FAQ, README, INSTALL.

Mon Jan 24 2005 - wnl (3.6alpha10)
	Updated aix43 module with ANSI function declarations and fixed
	declaration of get_system_info.  Configure now uses irixsgi
	module for irix6* systems.  Updates to the following modules:
	irixsgi, sunos5.  Fixed null pointer bug in color.c. Removed
	some useless code and definitions in display.c


Sun Nov 28 2004 - wnl (3.6alpha9)
	Replace AIX 5 module with alternate (bug 1056565).
	Fixed vulnerability in use of snprintf.

Fri Oct 22 2004 - wnl (3.6alpha8)
	Support for linux 2.6, added more stuff to memory and swap lines.
	Updated linuxthr module, which is only useful on 2.4 and earlier.
	Added some color support back in (feature request 930588), but
	still need to add it back to the per-process display.  Added
	OSF 5 support (untested).
	Fixed bug 1017951 (invalid process count argument not caught)

Tue Apr 20 2004 - wnl (3.6alpha7)
	Added 64 bit support for AIX.

Thu Apr 15 2004 - wnl (3.6alpha6)
        Included fixes for decosf1 pid size and updated module.  Also
        added osf1 to list of recognized operating systems in configure.ac.

Tue Mar 30 2004 - wnl (3.6alpha5)
	Minor bug fixes and some code rearrangement.  Changes to install
	rule.  Added several more platforms including: aix 4.2 thru 5,
	MacOS 10, Dec OSF, HPUX 7 thru 11.  Fixed the core dumping bug
	in linux.  Code cleanup, including sigdesc.h (by changing
	sigconv.awk).  Startup error messages are displayed on the
	first screen rather than beforehand (no more pause).  Cleaned
	up interrupt handling to avoid a race condition.  Eliminated
	top.local.h.  REMOVED Configure!!!

Mon Mar 22 2004 - wnl (3.6alpha1)
	Now using gnu autoconf.  Eliminated the need for CFLAGS and LIBS
	tags in the module source files.  Autoconf tries to figure all
	that out now.  Machine module interface now uses flags to determine
	if module supports sorting, selective display of idle processes,
	viewing full commands.  Added display of uptime for modules that
	support it.  Added display of full command lines for modules that
	support it.  3.5 modules must be changed a bit to work for 3.6:
	ORDER is no longer defined, and the module must fill in the
	appropriate fields in struct statics to get the extra features.
	Added a extenstion interface to allow for putting extra stuff
	on the screen -- this is still half baked and not documented.

Mon Feb 23 2004 - wnl (3.5)
	Turned rc1 in to version 3.5.  Only changes were to the FAQ.

Mon Feb  2 2004 - wnl (3.5rc1)
	Changed format_k (utils.c) to use MEMTYPE for its parameter.
	On most systems this is a long, but if the module defines 
	USE_SIZE_T, this is set to be a size_t.  The sunos5 module
	now defines it, so that it will work correctly on 64-bit
	machines.  New "linuxthr" module for rolling up processes
	that are really threads.  Configure autodetects when running
	on a 64-bit Solaris machine.

Tue Dec 16 2003 - wnl (3.5beta13)
	Improved linux module.  For Solaris, changed "THR" column
	heading to "LWP" since that's what they really are.

Thu Mar 30 2000 - wnl (3.5beta12)
	Updated modules: m_aix41.c, m_aix43.c, m_mtxinu.c, m_sco5.c,
	and m_ultrix4.c.
	Included m_irixsgi.c from some source that's been floating around
	SGI.  Don't yet know how it compares to m_irix62.

Fri Mar 10 2000 - wnl (3.5beta11)
	top.c: avoid potential loop if stdout gets closed, use macro
	for p_active to avoid collision with system macros.
	m_sunos5: widened some fields to accomodate 5.8.
	m_decosf1: added ordering support
	m_irix62_64: provides 64-bit module based on m_irix62.
	m_irix62: skip bogus files in /proc directory
	m_svr42MP and m_svr5: complete replacement with updated copies
	m_mtxinu: complete replacement with updated copies
	m_aix43: new module for 4.3
	getans: replaced with a Bourne shell script

Mon Mar  6 2000 - wnl (3.5beta10)
	m_sunos5.c: workaround for curses bug: ensure that TERMINFO has
	a value.

Fri Jan 15 1999 - wnl (3.5beta10)
	top.c: now check return code from read to avoid looping on eof.
	top.c: delay of 0 now only valid for root.
	decosf1.c: patches from Rainer Orth should fix most of the
	problems with this module (including the display of certain
	processes and runtime errors).
	sunos5.c: Rainer insisted on putting the slash back in the
	state field ("run/4") and widened the field to accomodate it.
	aix.c: widened PID field for 6-digit pids (shortened NICE field)
	module macosx added, thanks to Andrew Townley.

Fri Dec 18 1998 - wnl (3.5beta9)
	Configure checks status of "make" and complains if it fails.

Thu Dec 17 1998 - wnl (3.5beta9)
	Added module sco5 from Mike Hopkirk.
	Added module netbsd132 from moto kawasaki.

Sun Oct 25 1998 - wnl (3.5beta9)
	Added Casper's patches for sunos5 for the following:
	produce same results as swap -s (5.5 and higher),
	don't use system_pages kstat when /dev/kmem can be opened,
	skip . and .. when reading /proc, replace use of SOLARIS24
	with OSREV.

Fri Sep 11 1998 - wnl (3.5beta9)
	Added workaround to getans for the absence of $< in SCO Unix.

Wed Jul  1 1998 - wnl (3.5beta9)
	Changed structure member "errno" to "errnum" in commands.c.
	Replaced hpux10 module with one from John Haxby.

Fri Apr 17 1998 - wnl (3.5beta8)
	Moved definition of _KMEMUSER earlier in m_sunos5.c.  This should
	fix the compilation problem with gnu 2.7.2.3, obviating the need
	for the fixinc.svr4 patch, but hopefully will not affect anything
	else.
	Added -DORDER to m_sunos4mp.c

Tue Nov 18 1997 - wnl (3.5beta7)
	Added gcc 2.7.2.3 patch for fixinc.svr4 and changed INSTALL and
	FAQ to refer to it.
	Added NetBSD HP9000 fix.  Hopefully it doesn't break other 
	NetBSD platforms.

Fri Oct 24 1997 - wnl (3.5beta7)
	Modified m_dcosx.c to change uses of procdir to xprocdir, avoiding
	a name clash with an include file (Bryn Parrott)

Sat Oct 11 1997 - wnl (3.5beta6)
	Incorporated Casper's patches for Solaris 2.6 and for the multi-
	processor bug ("kstat finds too many cpus").

Sun Jan 20 1996 - wnl (3.5beta5)
	Fixed Casper's m_sunos5 module: there was a poor interaction with 
	his use of OSREV and SunOS 5.5.1.

Fri Dec 20 1996 - wnl (3.5beta4)
	Replaced m_sunos5 with a reworked version by Casper Dik.  This one
	should work under 2.6 and may not require that top be run setuid
	to root under 2.5 or 2.6.  This also fixed a bug in m_sunos5 that
	was introduced in beta3.
	Fixed calculation of OSREV in Configure.

Wed Nov 20 1996 - wnl (3.5beta3)
	Incorporated contributed fixes to:  bsdos2, irix62, freebsd20,
	ultrix4, sunos5.  Changed calculation of swap area in sunos5 (now
	uses swapctl).  sunos5 now understands idled processors.  Changed
	Configure to determine os revision using uname (when available)
	and adding it to machine.c compiliation in Makefile as -DOSREV.
	Changed calls to "exit" in modules to use "quit" instead.

Oct 20 1996 - wnl (3.5beta3)
	Removed "time" from list of ordering choices:  there's no easy way
	to get cpu time for all processes (it's in the u area).

Fri Oct 18 1996 - wnl (3.5beta3)
	hpux10 and hpux9: using a better means for determining when a
	process is idle.
	decosf1 now includes utils.h.

Fri Sep 13 1996 - wnl (3.5beta2)
	Fixed Configure to build Make.desc in such a way that doesn't
	require a long argument to sed.

Thu Sep 12 1996 - wnl (3.5beta2)
	Fixed bug in display.c that affected empty cpustate names.
	Created hpux1010 module - a variant of hpux10 that does not use
	struct proc or struct user (suitable for HP/UX 10.10).

Wed Sep 11 1996 - wnl (3.5beta2)
	Changes to sunos5 module:  Removed WCPU column since it is meaningless
	on a SVR4-based system.  Added THR column to show number of threads
	for each process.  This was not straightforward: the information is
	not stored in prpsinfo but rather in prstatus.

Tue Sep 10 1996 - wnl (3.5beta1)
	Added patches for sunos4mp to provide order support.
	Added irix62 module.
	Changed prime.c to include stdio.h for printf prototype.
	Added conditional code to os.h and utils.c to handle systems
	where sys_errlist is defined in stdio.h (such as NetBSD).

Mon Sep 09 1996 - wnl (3.5beta1)
	Removed tar and shar rules from Makefile.X -- don't need them anymore.
	Added -v option to display version number.  Updated man page.

Thu Aug 29 1996 - wnl (3.4)
	Replaced modules (from Tim Pugh): next 32, next40.
	Fixed bug in username.c: hashing negative uids.

Thu Aug 22 1996 - wnl (3.4beta3)
	Patched modules:  ultrix4, sunos4, sunos5, utek, decosf1, irix5.
	Added modules: next40, next32.
	Fixed procstates update bug in display.c.
	Fixed divide by zero bug in utils.c.
	Fixed bad number in layout.h
	Minor fixes to Configure.
	Complete overhaul of FAQ.

Tue Feb 13 1996 - wnl (3.4beta3)
	Added convex module from Warren Vosper (originally written by
	William Jones).

Tue Feb 13 1996 - wnl (3.4beta2)
	Fixed format_k in utils.c to calculate K and M values correctly.
	Added check for gigabyte values ('G').  Changed sumamry_format
	in display.c to use format_k where appropriate.
	Changed creation of distribution tar file to place everything in
	a top level directory.

Tue Jan 30 1996 - wnl (3.4beta2)
	Added m_aix41 module.  Added new tag type to module comments:
	TERMCAP, which defined the library to use for a termcap library.
	If no TERMCAP tag is found in the module's initial comment, then
	Configure will default to "-ltermcap".  AIX needs this since it
	put all the termcap routines in libcurses(!)

	Added m_bsdos2 (found lingering in my mailbox).
	Updated m_svr4 to include support for NCR multiprocessors.
	Fixed small bug in utils.c

Thu Jan 25 1996 - wnl (3.4beta1)
	Fixed m_sunos5 invocation of gettimeofday to include "NULL" as
	second argument.  This provides compatability with the Posix-
	compliant template provided with SunOS 5.5, but doesn't hurt
	previous versions since they do bother with a template for that
	function.

	Made changes (recommended by net users) to hpux10, ultrix4,
	netbsd10, aux3 (replaced aux31).  Added module for linux.

Fri Oct 10 1995 - wnl (3.4beta1)
	Added user-contributed modules for SCO Unix, IRIX 5, HP/UX 10,
	Pyramid DC/OSX.  Changed Configure so that it runs in environments
	whose c-shells have no 'eval'(!).  Added support for multiple sort
	ordering methods via the -o switch.  This option requires support
	from the machine dependent module: such support was added to
	sunos5 (thus sunos54) and sunos4.

	display.c:  Changed CPU states display line to shorten the leading
	tag if the data won't fit in the current width.  Fixed a divide-by-
	zero bug that affected ultrasparc servers (and potentially other
	systems).

	m_sunos5.c: Now asks the system for the correct pagesize rather than
	assuming it is 4K.

Thu Mar  2 1995 - wnl (3.3 RELEASE)
	Added module netbsd10 and renamed netbsd to netbsd08.  Changed
	Configure so that it does not use an initial default module name.
	Made other compatability fixes to Configure.  Added comments to
	decosf1 concerning optimizer bug.  Other documentation changes.
	Added use of "prime.c" to Configure script.

Tue Feb  7 1995 - wnl (3.3beta6)
	Still one more beta....
	Fixes for sunos5 2.4 gcc core dump (it was an alignment problem).
	Fixed and improvements for decosf1 (including use of format_k
	for proper SIZE column formatting).  Added modules freebsd20 and
	ncr3000.

Thu Feb  2 1995 - wnl (3.3beta5)
	One more beta....
	Fixed a few bugs in the sunos5 port pertaining to casting and
	very large memory counts.  Added "ifndef HAVE_GETOPT" to getopt.c
	to provide for conditional compilation of the getopt function.
	Those systems that have getopt in libc can add -DHAVE_GETOPT to
	the CFLAGS line in the module to prevent the function from being
	compiled.  Added sunos54 module to accomodate SunOS 5.4
	peculiarities.  Added module for aux3.1.

Wed Jan  4 1995 - wnl (3.3beta4)
	This is really taking too long......sigh.
	Fixed SIGWINCH handling	once and for all.  It now remembers the
        number of processes you	want displayed even thru window resizes.
	Fixed buffer conflict in utils.c (itoa and itoa7).
        Lots of small improvements to the various modules were made over
	the past month: too numberous to list here.  SunOS 5 module made
	more secure thru use of seteuid calls (other SVR4 modules should
	be modified similarly).  One final MP fix to sunos5, too.  Module
	for decosf1 was modified to accomodate V3.0.

Mon Apr 18 1994 - wnl (3.3beta3)
	I think I finally got a sunos5 module that will work on MP
	machines.  Fixed cpu states figure in osmp41a so that 
	percentages never exceed 100%.  Added shell script "install"
	since Unix vendors can't seem to make up their minds on what
	options they want to use for the one that comes with the OS.
	Added netbsd modules from Christos.  Fixed lots of other little
	things over the past few months that I have long since forgotten.

Wed Dec 15 1993 - wnl (3.3beta2)
	Added module patches from various users:  hpux9, sunos5.
	Fixed bug with batch mode (screen_width wasn't getting set).
	Changes to accomodate 64 bit machines.
	Fixed some bugs in command parsing ("renice 19 " did something
	unexpected).

Mon Aug 30 1993 - wnl (3.3beta)
	Added lots of little patches from various users.
	Added routines to utils.c for intelligent formatting of kilobytes
	and time.  These are intended to be used in the modules when
	formatting a process line.  Added code to "summary_format" in
	display.c to do intelligent formatting of memory quantities.
	Redid display.c to allow for varying line widths and dynamic
	reallocation of the screen buffer.
	Added a SIGWINCH handler to top.c!
	Added a constant, MAX_COLS, to top.h which defines the absolute
	widest line we will ever allow.  Changed allocations of "char fmt"
	in all machine modules to use this constant rather than an abitrary
	number.

Fri Aug 13 1993 - wnl (3.3)
	Changed return value definition of time-related functions in top.c,
	display.c, and m_ultrix4.c to time_t (stuart@coral.cs.jcu.edu.au).
	Fixed bug in display.c: line_update when start != 0.

Wed Aug  4 1993 - wnl (3.2 release)
	Changes to Configure from Paul Vixie.  Added modules for hpux9 and
	bsd386.

Tue Jul 13 1993 - wnl (3.1 release)
	More small changes and minor bug fixes.  Brought bsd44 up to date
	and added a module for svr4.2.  Changed shar packaging to use Rich
	Salz's cshar stuff.

Wed Jul  7 1993 - wnl (3.1BETA)
	More changes and bug fixes to Configure.  Applied some other
	minor bug fixes and suggestions from the beta testers.  Added
	the "metatop" shell script and the "installmeta" rule to the
	Makefile to make handling multiple machine models and OS versions
	easier.  Added INSTALL and FAQ files.

Tue May 18 1993 - wnl (3.1BETA)
	Changed Configure to be compatible with most SVR4 environments
	(differing output from "ls -lg").  Also changed Configure,
	Makefile.X, etc., to look for module files in the subdirectory
	"machine" (thanks to Christos Zoulas).

Tue Apr 20 1993 - wnl (3.1BETA)
	Changed both occurences of "ls -1" in Configure to "ls".  This
	SHOULD produce the same result, and has the advantage that it
	doesn't produce an error on a system 5 machine.  Integrated other
	changes recommended in the first round of beta testing.

Wed Mar 10 1993 - wnl (3.1BETA)
	MAJOR CHANGE:  I have added a required function to all machine
	dependent modules, called proc_owner.  It takes a pid as an argument
	and returns the uid of the process's owner.  Such capability is 
	necessary for top to run securely as a set-uid program, something
	that is needed for SVR4 implementations to read /proc.  I have
	retrofitted all modules except dgux with this function, but was
	not able to test most of them.  Top should now run securely as
	a setuid program.  Added 386bsd and sunos5 modules.  Added sunos4mp
	module for MP Suns.

Sat Feb 20 1993 - wnl (3.1ALPHA)
	Modified top.c and commands.c to compile correctly on System V
	derived Unixes (especially SVR4), but in a way that doesn't rely
	on an oracle-like declaration (that is, I don't use "ifdef SYSV").
	Fixed some bugs in "Configure" and "getans".  Added inspection of
	env variable "TOP" for options, and made -I default to showing
	idle processes.  Added "u" command to change username restriction
	on the fly.  Created shell script "suntop" for poor multi-version
	SunOS folks (like myself).

Wed Jun  3 1992 - wnl (3.0)
	"max_topn" wasn't being used everywhere it was supposed to be
	in top.c.  Many cosmetic changes, including copyright notices in
	all the .c files.  Version number is now handled by version.c and
	reflects the current patchlevel (which is initially set to 0).
	Changed Configure and Makefile to allow configurable variables for
	certain commands:  shell, cc, awk, install.  Updated README and
	Porting.  Ready to release to the world!

Mon May 18 1992 - wnl (2.9BETA)
	Added modules provided by Christos Zoulas.  Replaced screen.c
	with one modified by Christos and that will appropriately select
	and handle the sgtty, termio, or termios system.  Integrated many
	other changes recommended by Christos.  Fixed (I hope) the "-b"
	batch mode display bug.  Had to change loadavg to load_avg to avoid
	a conflict with 4.4BSD.  

Mon Apr 27 1992 - wnl (2.8BETA)
	Added modules provided by Daniel Trinkle.  Added patchlevel.h,
	but the patch level is not yet reflected in the version number.
	Cleaned up m_sunos4.c a little.

Wed Apr 22 1992 - wnl (2.8BETA)
	Major internal reorganization.  All of the system dependent stuff
	is now really and truly separated from everything else.  The
	system dependent functions are contained in a separate .c file
	called a "module".  The Configure script knows how to find and
	set up these modules, but the human installer still needs to tell
	Configure which module to use (no automagic determination of 
	machine type---sorry).  Added -U option to specify one user's
	processes, but there is no corresponding command...yet.  Other
	changes and improvements too numerous to mention here.  Currently
	there are only two modules:  sunos4 and umax.  But after this beta
	release is sent around, I expect more to be written.  I just hope
	that the machine-dependent abstractions don't need to change in
	the process.

Thu Mar 26 1992 - wnl (2.7BETA)
	Beta release with minimal architecture support.  Updated README
	and added a first cut at a Porting guide.  Added ioctl TIOCGWINSZ
	code from top2.5+ (courtesy of David MacKenzie).  I didn't even
	try porting the Ultrix support since I don't have access to an
	Ultrix machine.

Fri Oct 11 1991 - wnl (2.6)
	This version was not widely released.  It contained many changes.
	Here are the major ones:

	Put in Vixie's idle process hack.

	Enhanced type field in new_message to handle delayed messages.

	Changed u_process to automatically adjust for varying lines of
	output.  Management of screenbuf should now be completely contained
	in display.c.  Removed now extraneous code from CMD_number[12]
	portion of command switch in top.c.  This was the stuff that dealt
	with zeroing out lines in screenbuf.

	Finally made it all work correctly on a 386i.  Problems I had to
	overcome: kvm_nlist doesn't return 0 on success as advertised (it
	returns 1 instead); the results of a kvm_nlist are different
	(n_type can be zero even for a symbol that exists).

	Serious rearrangement for processor dependent stuff.  All nlists
	are now in separate files with the suffix ".nlist".  Most machine
	specific code is in "machine.c" surrounded by appropriate ifdefs---
	the goal is to eventually have all machine specific code in this
	file.  Managed to find a way to detect SunOS 4.x at compile-time:
	this is contained in the include file "sun.h".  Completely changed
	the memory display line for SunOS 4.x---it now displays a far
	more appropriate report.

	Created the shell script "Configure" to aid in the configuration
	step.

	Fixed a bug in init_termcap:  it will now tolerate an environment
	which does not have TERM defined (thanks to Sam Horrocks for
	pointing this out).

Tue Aug  9 1988 - wnl (2.5)
	Added changes to make top work under version 4.0 of the Sun
	operating system.  Changes were provided by Scott Alexander of the
	University of Pennsylvania.  Thanks!  Compile with "-Dsunos4" to
	get them.  Virtual memory statistics are not readily accessible
	under 4.0, so they don't show up in the output.

Thu Jul 31 1987 - wnl (2.4)
	Fixed a problem with the 4.0 Pyramid code.  The label "cp_time"
	doesn't exist in the 4.0 kernel anymore.  I think the code Carl
	sent me wants "percpu" instead.  That is what I am using and it
	appears to work.  375 code is still untested (at least by me).
	Also picked a great deal of lint out of the source.  Lint now only
	complains about a very few nitpicky things (there are far too many
	calls to "printf" to put a "(void)" in front of!), at least under
	SunOS.

Tue Jul 28 1987 - wnl (2.4a)
	Added changes for a Symmetrics Computer Systems s/375 machine.
	Changes were provided by Paul Vixie.  Thanks!  According to Mr.
	Vixie:  "These changes were not made at, by, or for SCS proper.
	SCS would probably be interested in them, but so far only the
	users' group has them.  They were made in February, 1987, to
	version 2.1 of the program, by Paul Vixie
	(dual!ptsfa!vixie!paul@ucbvax.Berkeley.EDU)."  His changes were
	integrated into version 2.3 to make version 2.4.

	The SCS peculiarities are summarized in Changes.scs.

Tue Jun  9 1987 - wnl (2.3 for real)
	Changed the includes for the extra code Carl sent me to only
	compile on Version 4.0 Pyramid machines.  This makes top still
	compilable on pre-4.0 Pyramids.  Specifically, this code is only
	compiled when both "pyr" and "CPUFOUND" are defined.

Wed Jun  3 1987 - wnl (2.3 with Pyramid additions)
	It's been a month and I still haven't done anything about
	distributing this version.  However, Carl Gutekunst from Pyramid
	has sent me some extra patches for some of the Pyramid code.  I
	just added those and will make them part of 2.3.  This fixes the
	following Pyramid problems:  adds the inclusion of <sys/systm.h>,
	uses the correct size for getting the kernel value _ccpu (this bug
	affected the Vax version as well), sums the elements of the percpu
	array to calculate a cp_time value (for OSx 4.0).

Fri May  1 1987 - wnl (2.3)
	I have finally finished all the changes for better support of
	oddbal terminals.  Added the low-level routine "clear_eol" which
	makes handling terminals without "ce" easy:  it uses spaces
	instead.  All direct uses of "clear_line" outside of screen.c have
	been changed to use this primitive.  A terminal with "os" is now
	handled in such that all situations that need overwriting are
	completely avoided (including several commands).  This required
	some changes to the way commands are translated into action (in
	"top.c").  Made several important changes to display.c to prevent
	overflowing of any of the fields.  Specifically, more than 99
	total processes and a cpu state that reaches 100%.  Had to make a
	small change to two casts in top.c, because the Sun 3.2 compiler
	was giving warnings on them.  Added the "-q" option which lets
	root run top at a nice of -20 (in case he thinks he really needs it).

Tue Dec 30 1986 - wnl (2.2)
	I think I fixed a bug reported by Julian Onions at Nottingham.
	Occasionally, top will core dump when the sprintf in either
	i_process or u_process overflows due to an exceptionally
	unrealistic time value.  I think it highly unlikely that top can
	get a bad proc structure (although I suppose it is possible), but
	the process time is read from the user structure, and that can
	sometimes be part garbage.  So, "get_ucpu" checks the value it
	returns to make sure its formatted form will not overflow the
	sprintf.  If this doesn't fix the bug, then more drastic measures
	will be necessary.  I plan to make this version the official
	"top 2.2".  [[ This version was never distributed very widely. ]]

Tue Dec  2 1986 - wnl (2.2c)
	Added to top.c the notion of a "failed command".  When a command
	produces a message (on the message line), an update does not
	follow it.  Before, the message was written and a new display was
	shown---purposefully not overwriting the message.  But the
	improvements to handle overstriking terminals and terminals
	without "ce" clear the screen before every display, which would
	erase the message.  Now, the message is displayed and top waits
	another full time interval before updating the display.  This
	works much better all around.

Mon Nov 24 1986 - wnl (2.2b)
	Created a new file, utils.c, and made appropriate changes to
	Makefile.  This new file holds all utility functions that can and
	may be used by more than one "module".  Improved i_memory and
	u_memory (display.c) so that screen updates for the values
	displayed are only changed when necessary.  Also made the line
	look better:  the last fixes made for a rather ugly display.
	Added the locally defined constant "LoadMax" and added code to
	top.c to send the cursor home after a space command is entered if
	the load average is higher than "LoadMax".  This provides visual
	feedback on loaded systems.

Mon Nov  3 1986 - wnl (2.2a)
	Widened the format for memory usage so that it can display 5
	digits.  This makes that line look a little ugly---maybe I'll fix
	that later.  Screen handling now understands "os" and a missing
	"ce".  It treats them identically:  clear the screen between each
	display.  Screen handling code now uses "cd" when appropriate
	(i.e.:  when user has shortened the screen).  Made i_loadave clear
	then screen and took out most of the explicit calls to "clear" in
	top.c.  This method is cleaner, especially in conjunction with
	"os" handling.  Added preprocessor variable "RANDOM_PW" for
	systems that access the passwd file randomly (Sun's yp and 4.3).
	With "RANDOM_PW" set, "getpwuid" is used instead of "getpwnam",
	but uid->username mappings are still hashed internally (because
	that is still faster than going to disk).

Mon Oct  6 1986 - wnl (2.1)
	A bug with the kill command was pointed out by "dciem!tim"---
	specifying a signal by name did not work correctly.  This bug has
	been fixed with a simple change to commands.c.  Another bug made
	the cpu state percentages incorrect the first time they were
	displayed.  This bug has also been fixed (changed top.c).

Thu Sep  4 1986 - wnl (2.0, at last)
	This is the version that will (hopefully) get released to the
	world as top 2.0.
	Added the "r" and "k" commands for renice and kill, respectively.
	This required adding a way to handle system call errors, and the
	addition of the "e" command.  Help screen and manual page were
	changed to reflect this change.  Changed all "#ifdef SUN" directives
	to "#ifdef sun", and changed all "#ifdef PYRAMID" directives to
	"#ifdef pyr".  As much as I hate those choices of preprocessor
	names (they too easily conflict with real variable names), it does
	make automatic compilation possible---people don't have to change
	the Makefile anymore for specific machines.  The manual page was
	changed to automatically incorporate the defaults as set in the
	Makefile (including an infinite value for TOPN) and the way the
	manual page is generated by the Makefile was changed to make
	maintenance of this information automatic.

Mon Jul 28 1986 - wnl (still pre 2.0)
	Real close now.  I put in a new definition for the macro "pagetok"
	that does an explicit shift of a constant expression involving
	PGSHIFT.  Appropriate checks are made if PGSHIFT is to small.
	"pagetok" is now used exclusively everywhere to convert kernel
	clicks to kilobytes.  I added a full blown interactive mode with
	the ability to change some of the runtime parameters (how many to
	display, time delay, etc.) while top is running.  I also
	incorporated a few ideas from the net:  control characters in the
	command name are replaced with '?'; the '-S' option makes the
	swapper and pager visible; options have been added to control the
	number of displays produced (this makes it easier to make
	performance snapshots with top).  I have also added the notion of
	"infinite" values for number of processes and number of displays.
	I fixed a long-standing bug in the uid to username mapping code
	that was only aggravated on the pyramids:  it was an ill-defined
	expression (akin to i = i++).  I tweaked the proc_compar routine
	for qsort slightly so that stopped processes were more likely to
	show up.  Manual page was updated to reflect all changes
	noticeable to the user.

Tue Jul  1 1986 - wnl (pre 2.0 -- 1.9999?)
	In the process of major revamping on the way to version 2.0.
	I have completely done away with curses by adding my own screen
	management routines in a separate file (screen.c).  The rationale
	for this is that top knows a whole lot more about what is and is
	not redundant on the screen and can compare simple integer values
	where curses would have to compare strings.  This has turned out
	to be a very big win speed-wise.  The proc_compar routine for
	sorting has been rewritten to include several more keys.  I
	decided this was necessary when I noticed that the "top" process
	itself kept disappearing off the top 10 list on a Sun-3.  All the
	processes had the same percentage (0%) and the sort wasn't really
	doing anything worthwhile.  I changed the expression that computes
	memory usage to use the ctob macro instead of just assuming that
	pages were 512 bytes.  More work still needs to be done before
	this version is usable.  I changed options-processing to use
	getopt and added appropriate incantations to the Makefile.

Wed Feb 20 1985 - wnl (still 1.8)
	Put in the ifdef FOUR_ONE statements to make top still compilable
	on a 4.1 system.  Apparently, there are some users out there that
	need this functionality.  Oh well.  I don't guarantee any of it,
	since I can't test it.  Made appropriate changes to README and
	final installation related changes to Makefile.

Sat Feb  2 1985 - wnl (1.8)
	Removed all the ifdef FOUR_TWO statements and made "top" into a
	4.2 only program.  If someone really wants to still run it on 4.1,
	then they can do all the work.  We don't have a 4.1 machine
	anymore, so I don't even know if the thing still works under 4.1.
	Cleaned up the Makefile and the README.  Added installation rules
	to the Makefile, as requested by several sites.  Fixed a very
	obscure divide-by-zero bug.  Added a second "key" to the qsort
	comparison function (proc_compar) so that comparisons are based on
	cpu ticks if the percentages are equal (provided by Jonathon
	Feiber at Sun).

Tue Dec 11 1984 - wnl (1.7)
	Added the virtual and real memory status line to the header area
	(provided by Jonathon Feiber at Sun)

Tue Nov 20 1984 - wnl (1.6)
	Added an "exit" if sbrk's fail.  Added changes from Jonathon
	Feiber at Sun:  ifdef SUN to make top work on Suns (they don't use
	doubles in the proc structure), register declarations, check for
	getting a user structure that has disappeared since the proc array
	was read (it used to die, now it just shows the process as swapped).

Tue Nov 13 1984 - wnl (1.5)
	If the number of displayable processes ("active_procs") was less
	than the number of requested processes ("topn"), top would
	segmentation fault.  This bug has been fixed.  Thanks to Prentiss
	Riddle at ut-sally for pointing out the existence of this bug.

Tue Oct 23 1984 - wnl (1.4)
	Finally fixed the hash table bug that caused processes owned by
	root to sometimes appear with either no name or a different name
	that had UID 0 (such as "operator").  Removed all the ifdef DEBUG
	blocks to make top ready for distribution to the real world.

Sun Apr  8 1984 - wnl (still 1.3)
	Made some slight changes to the display format.  It now looks more
	aesthetically pleasing.  Added some preprocessor constants so that
	the two defaults (number of processes and seconds of delay) easier
	to change.

Thu Apr  5 1984 - wnl (1.3)
	Changed the order in which things are done at initialization time.
	This way, if an error occurs before starting the main loop, curses
	will never get started.  Also changed other error handlers so that
	endwin() is called before any flavor of exit.  Specifying a number
	of processes that is more than the screen can handle is no longer
	fatal.  It displays a warning message and pretends the user
	specified the maximum for the screen.  Finally cured all the TSTP
	blues (well, almost all).  I removed my TSTP handler and convinced
	the system to always use the one that curses sets up.  Turns out
	that "sleep" was stepping all over it during a pause.  So, I don't
	use sleep anymore.  The only problem that remains with it now is
	redrawing the old display before updating it after a pause.

Tue Apr  3 1984 - wnl (from 1.0 to 1.2)
	I changed the format of the TIME column from just "seconds" to
	"minutes:seconds".  I also made pausing work correctly.  Screen
	redraws with an up to date display.  For compatibility with 4.2, I
	changed the name of the "zero" function to "bzero".  The makefile
	has been altered to handle versions for 4.1 and 4.2, and README
	has been updated to reflect these recent changes.