Compiling KLH10 - Revision history

Jnc: +cat, +links

2018-12-16T04:26:39Z

+cat, +links

← Older revision		Revision as of 04:26, 16 December 2018
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

	This is a brief guide to compiling Ken Harrenstien's KLH10 PDP-10 ~~emulator~~. It was written on an AMD64 Gentoo machine with 2GB RAM and gcc 4.5.3-r1. The author currently has a bad cold, so please excuse any mistakes/foolishness caused by light-headedness.		This is a brief guide to compiling Ken Harrenstien's [[KLH10]] [[PDP-10]] [[simulator]]. It was written on an [[AMD64]] Gentoo machine with 2GB RAM and gcc 4.5.3-r1. The author currently has a bad cold, so please excuse any mistakes/foolishness caused by light-headedness.

	I was satisfied with using [[SIMH]] to run MIT's [[ITS]] operating system, but there was an annoying bug: the reported time of the system looped endlessly over three hours, and did not seem to keep proper time. Was the clock running too fast? It seemed to be okay, but something was amiss with the way that ITS reads the clock. In an effort to narrow down the cause, I decided to get [[KLH10]] running and see if it exhibited the same problem. I have not found an answer yet.		I was satisfied with using [[SIMH]] to run MIT's [[Incompatible Timesharing System\|ITS]] [[operating system]], but there was an annoying bug: the reported time of the system looped endlessly over three hours, and did not seem to keep proper time. Was the clock running too fast? It seemed to be okay, but something was amiss with the way that ITS reads the clock. In an effort to narrow down the cause, I decided to get KLH10 running and see if it exhibited the same problem. I have not found an answer yet.

	== Useful links ==		== Useful links ==
Line 12:		Line 12:
	== Requirements ==		== Requirements ==

	This tutorial assumes that you are running a Linux system with a modern version of gcc. Some of these instructions will not apply to your system, or may differ. I am using a current Gentoo system, as of February 2012. The system has been configured as a 'multilib' configuration, with a mixture of 32- and 64-bit. By default, gcc compiles for 64-bit.		This tutorial assumes that you are running a [[Linux]] system with a modern version of gcc. Some of these instructions will not apply to your system, or may differ. I am using a current Gentoo system, as of February 2012. The system has been configured as a 'multilib' configuration, with a mixture of 32- and 64-bit. By default, gcc compiles for 64-bit.

	== Compilation ==		== Compilation ==
Line 102:		Line 102:

	[[User:Lexthehex\|Lexthehex]] 22:41, 25 February 2012 (PST)		[[User:Lexthehex\|Lexthehex]] 22:41, 25 February 2012 (PST)

			[[Category: Tutorials]]

Lexthehex: /* Diff files (output of 'patch -u') */ -- Removed information about the binaries being in the build dir (obvious!).

2012-02-26T20:01:18Z

Diff files (output of 'patch -u'): -- Removed information about the binaries being in the build dir (obvious!).

← Older revision		Revision as of 20:01, 26 February 2012
Line 98:		Line 98:

	The Wiki may edit these if I paste them verbatim, so I have made [[http://brooknet.imap.cc/klh10_diffs_260212_0617.txt them]] available on my webserver (I was not able to upload them due to browser difficulties). There are four patches to files cenv.h, dvlites.c, klh10.c and kn10def.h. These include the kn10def.c patch. ''[Please verify]''		The Wiki may edit these if I paste them verbatim, so I have made [[http://brooknet.imap.cc/klh10_diffs_260212_0617.txt them]] available on my webserver (I was not able to upload them due to browser difficulties). There are four patches to files cenv.h, dvlites.c, klh10.c and kn10def.h. These include the kn10def.c patch. ''[Please verify]''

	~~After compilation, you should find that the platform build directory ('klh10-2.0h/bld/lnx86/') contains executables for dpni20, dprpxx, dptm03, kn10-kl, tapedd, uexbconv, vdkfmt, wfconv and wxtest.~~

	~~Other issues: 'make ks' and 'make ks-its' abort with undefined references. Oh.. do a 'make clean' and try again, and they should compile. ''(much embarrassment)''~~

	The next stage is to create a klh10 configuration file, which the install.txt file describes as 'semi-optional'. The remaining steps are quite straightforward, so I will not list them here. The binaries are copied to $KLH10_HOME and kn10-kl (or kn10-ks) are started up, with the config file as an optional argument. If you wish to use the networking facilities of KL and KS-ITS, making dpni20 and dpimp 'setuid root' is required - see the 'INSTALLING BINARIES' section of install.txt.		The next stage is to create a klh10 configuration file, which the install.txt file describes as 'semi-optional'. The remaining steps are quite straightforward, so I will not list them here. The binaries are copied to $KLH10_HOME and kn10-kl (or kn10-ks) are started up, with the config file as an optional argument. If you wish to use the networking facilities of KL and KS-ITS, making dpni20 and dpimp 'setuid root' is required - see the 'INSTALLING BINARIES' section of install.txt.

	[[User:Lexthehex\|Lexthehex]] 22:41, 25 February 2012 (PST)		[[User:Lexthehex\|Lexthehex]] 22:41, 25 February 2012 (PST)

Lexthehex: /* Compilation */ -- Edited the build script

2012-02-26T19:59:16Z

Compilation: -- Edited the build script

← Older revision		Revision as of 19:59, 26 February 2012
Line 88:		Line 88:
	make -f ../../src/Makefile.mk clean ${BUILD} CONFFLAGS_AUX="-DKLH10_I_CIRC=1 -DKLH10_DEV_LITES=1" LDFLAGS="-static"		make -f ../../src/Makefile.mk clean ${BUILD} CONFFLAGS_AUX="-DKLH10_I_CIRC=1 -DKLH10_DEV_LITES=1" LDFLAGS="-static"
	for a in *; do		for a in *; do
	file "${a}" \| grep -q "executable" && mv ${a} /dev/shm/klh10_bins/		file "${a}" \| grep -q "executable" && [ "${a}" != "00build" ] && mv ${a} /dev/shm/klh10_bins/
	done		done
	echo "Finished building ${BUILD}. Press Enter to continue."		echo "Finished building ${BUILD}. Press Enter to continue."
	read a		read a
	done		done
			rm -f *.o

	=== Diff files (output of 'patch -u') ===		=== Diff files (output of 'patch -u') ===

Lexthehex: /* Compilation */ -- Added a helper script

2012-02-26T19:47:30Z

Compilation: -- Added a helper script

← Older revision		Revision as of 19:47, 26 February 2012
Line 82:		Line 82:

	The '-DKLH10_DEV_LITES=1' definition is required, and is also needed for other targets ('base-ks' and 'base-ks-its').		The '-DKLH10_DEV_LITES=1' definition is required, and is also needed for other targets ('base-ks' and 'base-ks-its').

			To compile all of the binaries, I used a loop that cycled through the build/clean process and at the end of the pass, copied the executables to a temporary dir ('/dev/shm/klh10_bins/'). I'm sure that there's a more-elegant way of doing this.

			for BUILD in base-{kl,ks,ks-its}; do
			make -f ../../src/Makefile.mk clean ${BUILD} CONFFLAGS_AUX="-DKLH10_I_CIRC=1 -DKLH10_DEV_LITES=1" LDFLAGS="-static"
			for a in *; do
			file "${a}" \| grep -q "executable" && mv ${a} /dev/shm/klh10_bins/
			done
			echo "Finished building ${BUILD}. Press Enter to continue."
			read a
			done

	=== Diff files (output of 'patch -u') ===		=== Diff files (output of 'patch -u') ===

Lexthehex: /* Compilation */ -- Verified that -DKLH10_DEV_LITES=1 is necessary.

2012-02-26T19:31:19Z

Compilation: -- Verified that -DKLH10_DEV_LITES=1 is necessary.

← Older revision		Revision as of 19:31, 26 February 2012
Line 81:		Line 81:
	make -f ../../src/Makefile.mk base-kl CONFFLAGS_AUX="-DKLH10_I_CIRC=1 -DKLH10_DEV_LITES=1" LDFLAGS="-static"		make -f ../../src/Makefile.mk base-kl CONFFLAGS_AUX="-DKLH10_I_CIRC=1 -DKLH10_DEV_LITES=1" LDFLAGS="-static"

	~~You may not need the~~ '-DKLH10_DEV_LITES=1' definition, ~~as I added this while testing [note to self: tidy this document!]~~.		The '-DKLH10_DEV_LITES=1' definition is required, and is also needed for other targets ('base-ks' and 'base-ks-its').

	=== Diff files (output of 'patch -u') ===		=== Diff files (output of 'patch -u') ===

Lexthehex: /* Compilation */ -- Added some stuff at the end. I'm not sure if it's really required.

2012-02-26T18:11:08Z

Compilation: -- Added some stuff at the end. I'm not sure if it's really required.

← Older revision		Revision as of 18:11, 26 February 2012
Line 20:		Line 20:
	Step 2: unpack the source - easy: 'tar -xzf panda-dist.tar.gz'		Step 2: unpack the source - easy: 'tar -xzf panda-dist.tar.gz'

	Step 3: compile the source. ~~Here's~~ where I got lost. The instructions (panda-dist/klh10-2.0h/doc/install.txt) tell you to:		Step 3: compile the source. I admit that here was where I got lost! The instructions (panda-dist/klh10-2.0h/doc/install.txt) tell you to:

	# Unpack the main distribution, and the auxiliary distribution (I didn't, as I don't need it yet).		# Unpack the main distribution, and the auxiliary distribution (I didn't, as I don't need it yet).
Line 90:		Line 90:

	Other issues: 'make ks' and 'make ks-its' abort with undefined references. Oh.. do a 'make clean' and try again, and they should compile. ''(much embarrassment)''		Other issues: 'make ks' and 'make ks-its' abort with undefined references. Oh.. do a 'make clean' and try again, and they should compile. ''(much embarrassment)''

			The next stage is to create a klh10 configuration file, which the install.txt file describes as 'semi-optional'. The remaining steps are quite straightforward, so I will not list them here. The binaries are copied to $KLH10_HOME and kn10-kl (or kn10-ks) are started up, with the config file as an optional argument. If you wish to use the networking facilities of KL and KS-ITS, making dpni20 and dpimp 'setuid root' is required - see the 'INSTALLING BINARIES' section of install.txt.

	[[User:Lexthehex\|Lexthehex]] 22:41, 25 February 2012 (PST)		[[User:Lexthehex\|Lexthehex]] 22:41, 25 February 2012 (PST)

Lexthehex: /* Requirements */ -- (Verified: my gcc compiles for 64-bit by default.)

2012-02-26T17:58:31Z

Requirements: -- (Verified: my gcc compiles for 64-bit by default.)

← Older revision		Revision as of 17:58, 26 February 2012
Line 12:		Line 12:
	== Requirements ==		== Requirements ==

	This tutorial assumes that you are running a Linux system with a modern version of gcc. Some of these instructions will not apply to your system, or may differ. I am using a current Gentoo system, as of February 2012. The system has been configured as a 'multilib' configuration, with a mixture of 32- and 64-bit. By default, gcc compiles for 64-bit. ~~''(verify this)''~~		This tutorial assumes that you are running a Linux system with a modern version of gcc. Some of these instructions will not apply to your system, or may differ. I am using a current Gentoo system, as of February 2012. The system has been configured as a 'multilib' configuration, with a mixture of 32- and 64-bit. By default, gcc compiles for 64-bit.

	== Compilation ==		== Compilation ==

Lexthehex: /* Introduction */ -- corrected spelling of 'Ken Harrenstien'

2012-02-26T17:56:32Z

Introduction: -- corrected spelling of 'Ken Harrenstien'

← Older revision		Revision as of 17:56, 26 February 2012
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

	This is a brief guide to compiling Ken ~~Harrenstein~~'s KLH10 PDP-10 emulator. It was written on an AMD64 Gentoo machine with 2GB RAM and gcc 4.5.3-r1. The author currently has a bad cold, so please excuse any mistakes/foolishness caused by light-headedness.		This is a brief guide to compiling Ken Harrenstien's KLH10 PDP-10 emulator. It was written on an AMD64 Gentoo machine with 2GB RAM and gcc 4.5.3-r1. The author currently has a bad cold, so please excuse any mistakes/foolishness caused by light-headedness.

	I was satisfied with using [[SIMH]] to run MIT's [[ITS]] operating system, but there was an annoying bug: the reported time of the system looped endlessly over three hours, and did not seem to keep proper time. Was the clock running too fast? It seemed to be okay, but something was amiss with the way that ITS reads the clock. In an effort to narrow down the cause, I decided to get [[KLH10]] running and see if it exhibited the same problem. I have not found an answer yet.		I was satisfied with using [[SIMH]] to run MIT's [[ITS]] operating system, but there was an annoying bug: the reported time of the system looped endlessly over three hours, and did not seem to keep proper time. Was the clock running too fast? It seemed to be okay, but something was amiss with the way that ITS reads the clock. In an effort to narrow down the cause, I decided to get [[KLH10]] running and see if it exhibited the same problem. I have not found an answer yet.

Lexthehex: Compiling KLH10 on Gentoo x86_64 -- compilation for other targets

2012-02-26T06:41:58Z

Compiling KLH10 on Gentoo x86_64 -- compilation for other targets

← Older revision		Revision as of 06:41, 26 February 2012
Line 87:		Line 87:
	The Wiki may edit these if I paste them verbatim, so I have made [[http://brooknet.imap.cc/klh10_diffs_260212_0617.txt them]] available on my webserver (I was not able to upload them due to browser difficulties). There are four patches to files cenv.h, dvlites.c, klh10.c and kn10def.h. These include the kn10def.c patch. ''[Please verify]''		The Wiki may edit these if I paste them verbatim, so I have made [[http://brooknet.imap.cc/klh10_diffs_260212_0617.txt them]] available on my webserver (I was not able to upload them due to browser difficulties). There are four patches to files cenv.h, dvlites.c, klh10.c and kn10def.h. These include the kn10def.c patch. ''[Please verify]''

	[[User:Lexthehex\|Lexthehex]] 22:36, 25 February 2012 (PST)		After compilation, you should find that the platform build directory ('klh10-2.0h/bld/lnx86/') contains executables for dpni20, dprpxx, dptm03, kn10-kl, tapedd, uexbconv, vdkfmt, wfconv and wxtest.

			Other issues: 'make ks' and 'make ks-its' abort with undefined references. Oh.. do a 'make clean' and try again, and they should compile. ''(much embarrassment)''

			[[User:Lexthehex\|Lexthehex]] 22:41, 25 February 2012 (PST)

Lexthehex: Compiling KLH10 on Gentoo x86_64 -- added a bracket

2012-02-26T06:36:03Z

Compiling KLH10 on Gentoo x86_64 -- added a bracket

← Older revision		Revision as of 06:36, 26 February 2012
Line 62:		Line 62:
	I.e. change the '=' to a space.		I.e. change the '=' to a space.

	Repeating the 'make base-kl ...' command should cause compilation to progress a bit further, before it aborts with an undefined reference to 'lites_init'. That function is in src/dvlites.c, and is an addition that the Panda team added: it sends the processor status over the parallel port, where it is displayed by a custom bit of hardware (a microcontroller, as designed by [http://www.sparetimegizmos.com Spare Time Gizmos]. I have almost all of the parts for this device, but alas! My computer doesn't have a parallel port, and no serial port either. I'll have to think of another way to display the CPU status, and I have thought of a few:		Repeating the 'make base-kl ...' command should cause compilation to progress a bit further, before it aborts with an undefined reference to 'lites_init'. That function is in src/dvlites.c, and is an addition that the Panda team added: it sends the processor status over the parallel port, where it is displayed by a custom bit of hardware (a microcontroller, as designed by [http://www.sparetimegizmos.com Spare Time Gizmos]). I have almost all of the parts for this device, but alas! My computer doesn't have a parallel port, and no serial port either. I'll have to think of another way to display the CPU status, and I have thought of a few:

	# Display the CPU status as a window on the screen.		# Display the CPU status as a window on the screen.
Line 87:		Line 87:
	The Wiki may edit these if I paste them verbatim, so I have made [[http://brooknet.imap.cc/klh10_diffs_260212_0617.txt them]] available on my webserver (I was not able to upload them due to browser difficulties). There are four patches to files cenv.h, dvlites.c, klh10.c and kn10def.h. These include the kn10def.c patch. ''[Please verify]''		The Wiki may edit these if I paste them verbatim, so I have made [[http://brooknet.imap.cc/klh10_diffs_260212_0617.txt them]] available on my webserver (I was not able to upload them due to browser difficulties). There are four patches to files cenv.h, dvlites.c, klh10.c and kn10def.h. These include the kn10def.c patch. ''[Please verify]''

	[[User:Lexthehex\|Lexthehex]] 22:33, 25 February 2012 (PST)		[[User:Lexthehex\|Lexthehex]] 22:36, 25 February 2012 (PST)