Create installation.md
This commit is contained in:
ken rector
GitHub
183
Csystem/installation.md
Normal file
183
Csystem/installation.md
Normal file
@@ -0,0 +1,183 @@
|
||||
|
||||
These are steps to install the Telefile C system on F00. They
|
||||
include rebuilding :PC and :PCC libraries to correct a bug that
|
||||
causes a MEMORY PROTECTION VIOLATION during initialization of
|
||||
the C program.
|
||||
|
||||
1. Bring up a CP-V F00 system.
|
||||
Make sure that :SYS account has an online 9T resource and
|
||||
online C0 privilege.
|
||||
|
||||
!SUPER
|
||||
SUPER HERE
|
||||
|
||||
M :SYS,LBE
|
||||
B$PR=C0;O$PR=C0
|
||||
OMCO=64;BMCO=64
|
||||
BM9T=1;OM9T=1
|
||||
BMPDIS=32000;OMPDIS=32000
|
||||
|
||||
END
|
||||
|
||||
2. Log off and back on to setup the SYS account.
|
||||
|
||||
3. Restore the compiler and .CLIB accounts from the FRES tapes.
|
||||
These will be 30b0.tap and 81b0-2.tap files. The simh attach
|
||||
command expects these files to be in the current directory.
|
||||
|
||||
Keep a copy of the FRES restore listing as it will be helpful later.
|
||||
|
||||
FRES
|
||||
+VOL
|
||||
30B0
|
||||
+END
|
||||
|
||||
FRES
|
||||
+VOL
|
||||
81B0
|
||||
+END
|
||||
|
||||
4. Make copies of DRSP, LYNX and LOADER IN :SYS to a scratch account
|
||||
and patch them to allow use of the library name :PC and :PCC
|
||||
to avoid the :Pnn name restriction of F00.
|
||||
|
||||
C DRSP TO DRSP.KEN
|
||||
GENMD DRSP.:SYS
|
||||
,+AE74,6800AE7C
|
||||
END
|
||||
|
||||
C LYNX TO LYNX.KEN
|
||||
GENMD LYNX.:SYS
|
||||
,+A7AB,6800A865
|
||||
END
|
||||
|
||||
C LOADER OVER LOADER.KEN
|
||||
GENMD LOADER
|
||||
PS1, +AB70,227FFF00
|
||||
END
|
||||
|
||||
5. Install CCX and :PCC in the shared processor tables.
|
||||
See J:INSTALL.CCXA00JC script.
|
||||
|
||||
|
||||
DRSP
|
||||
DROP CCX,PERM
|
||||
ENTER CCX FROM SP:CCX.CCXA00SP,M
|
||||
DROP :PCC,PERM
|
||||
ENTER :PCC FROM :PCC.CCLA00SP,S,P
|
||||
END
|
||||
|
||||
6. Copy the compiler and other programs to :SYS.
|
||||
|
||||
PCL
|
||||
COPY :PC.CCLA00SP OVER :PC.:SYS(RD(ALL))
|
||||
COPY SP:CC.CCXA00SP OVER CC.:SYS(EX(ALL))
|
||||
COPY SP:CCX.CCXA00SP OVER CCX.:SYS(EX(ALL))
|
||||
COPY SP:CPP.CCXA00SP OVER CPP.:SYS(EX(ALL))
|
||||
COPY SP:CCA.CCXA00SP OVER CCA.:SYS(EX(ALL))
|
||||
COPY SP:CMP.CCXA00SP OVER CMP.:SYS(EX(ALL))
|
||||
COPY SP:CHK.CCXA00SP OVER CHK.:SYS(EX(ALL))
|
||||
COPY SP:YACC.CCXA00SP OVER YACC.:SYS(EX(ALL))
|
||||
COPY SP:UPDATE.CCXA00SP OVER UPDATE.:SYS(EX(ALL))
|
||||
END
|
||||
|
||||
|
||||
|
||||
8. The C library on the 30b0 tape was built incorrectly
|
||||
and does not define the correct size for the type 00 DATA section
|
||||
of :PC. This problem causes a MEMORY PROTECTION VIOLATION
|
||||
when initializing C programs.
|
||||
|
||||
To correct this problem rebuild the :PC module with
|
||||
BOR:PCDATA.CCLA00BO, instead of BO:PCDATA.CCLA00BO using the
|
||||
following scripts. This will build both :PCC and :PC
|
||||
modules but we won't use the :PCC module.
|
||||
|
||||
Note the intermediate output from these links is saved in the .KEN scratch
|
||||
account.
|
||||
|
||||
And, also be sure you are using the patched versions of LYNX.
|
||||
|
||||
LYNX BOR:PCDATA.CCLA00BO;
|
||||
OVER :PCCDATA.KEN;
|
||||
(RD,NONE),(EX,NONE),;
|
||||
(NL),(NTCB),(SL,F),(SS),(MN)
|
||||
SET M:EI /:PCCDATA.KEN
|
||||
SET M:EO /:PCDATA.KEN
|
||||
DEFCOM
|
||||
|
||||
|
||||
LYNX :J0.:SYS,;
|
||||
:PCDATA.KEN,;
|
||||
BO:CTYPE.CCLA00BO,;
|
||||
BO:LIB.CCLA00BO,;
|
||||
BO:CMAIN1.CCLA00BO,;
|
||||
BO:DOPRINT.CCLA00BO,;
|
||||
BO:ECVT.CCLA00BO,;
|
||||
BO:FGETS.CCLA00BO,;
|
||||
BO:FILBUF.CCLA00BO,;
|
||||
BO:FINDIOP.CCLA00BO,;
|
||||
BO:FLSBUF.CCLA00BO,;
|
||||
BO:FOPEN.CCLA00BO,;
|
||||
BO:FPRINTF.CCLA00BO,;
|
||||
BO:FPUTS.CCLA00BO,;
|
||||
BO:FREAD.CCLA00BO,;
|
||||
BO:FWRITE.CCLA00BO,;
|
||||
BO:GETS.CCLA00BO,;
|
||||
BO:IO.CCLA00BO,;
|
||||
BO:ISATTY.CCLA00BO,;
|
||||
BO:MALLOC.CCLA00BO,;
|
||||
BO:PRINTF.CCLA00BO,;
|
||||
BO:SBRK.CCLA00BO,;
|
||||
BO:SETBUF.CCLA00BO,;
|
||||
BO:SPRINTF.CCLA00BO,;
|
||||
BO:SCANF.CCLA00BO,;
|
||||
BO:DOSCAN.CCLA00BO,;
|
||||
BO:ATOF.CCLA00BO,;
|
||||
BO:UNGETC.CCLA00BO,;
|
||||
BO:F2I.CCLA00BO,;
|
||||
BO:PROFILE.CCLA00BO,;
|
||||
BO:STR.CCLA00BO,;
|
||||
BO:ATOI.CCLA00BO,;
|
||||
BO:CALLOC.CCLA00BO,;
|
||||
BO:PROPRIN.CCLA00BO ;
|
||||
OVER :PCC.KEN ;
|
||||
(RD,NONE),(EX,ALL),;
|
||||
(LB,1C200),(NL),(NTCB),;
|
||||
(SL,F),(SS)
|
||||
SET M:EI /:PCC.KEN
|
||||
SET M:EO /:PC.KEN
|
||||
DEFCOM
|
||||
C :PC.KEN OVER :PC.:SYS
|
||||
|
||||
9. Compile the sample HELLO WORLD program. The :PCC library
|
||||
must be installed as a shared library to run the complier
|
||||
and the run unit. The message
|
||||
|
||||
AA00 WHAT PUBLIC LIBRARY?
|
||||
|
||||
from CC indicates the :PCC library was not installed during
|
||||
step 5. Go back and do that again.
|
||||
|
||||
CC HELLO-C.CCXA00XX BO:HELLO.KEN
|
||||
|
||||
10. Link the rom with the :PC library and produce a load map.
|
||||
|
||||
LYNX (PC)BO:HELLO.KEN OVER LMN.KEN;.CLIB (M)
|
||||
|
||||
The load map for LMN.KEN should show size 3B4 for the 00 DATA
|
||||
section.
|
||||
|
||||
************ PROTECTION TYPES **********
|
||||
00 DATA 01 PROCEDURE 10 STATIC
|
||||
------- ------------ ---------
|
||||
HIGH: A3B3 A635 A5FF
|
||||
LOW : A000 A600 A400
|
||||
SIZE: 3B4 36 200
|
||||
|
||||
|
||||
10. Run the program and check the output.
|
||||
!LMN.KEN
|
||||
hello world
|
||||
|
||||
|
||||
Reference in New Issue
Block a user