home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / w32os204.zip / win32k.txt < prev   
Text File  |  1998-09-18  |  7KB  |  445 lines
  1. (Draft II)
  2.  
  3.  
  4.  
  5. Win32k v0.0.4Alpha
  6.  
  7. --------------------
  8.  
  9.  
  10.  
  11. This readme will give you all the information you need to use the "native"
  12.  
  13. PE-loader for os/2 (we hope).
  14.  
  15.  
  16.  
  17.  
  18.  
  19. Contents
  20.  
  21. ---------
  22.  
  23.     1.0 Warning/Disclaimer
  24.  
  25.  
  26.  
  27.     2.0 Requirements
  28.  
  29.  
  30.  
  31.     3.0 Installation
  32.  
  33.     3.1 MWDD32.SYS
  34.  
  35.     3.2 win32k.sys
  36.  
  37.     3.3 Options for win32k.sys
  38.  
  39.     3.4 Finished
  40.  
  41.  
  42.  
  43.     4.0 About Win32k
  44.  
  45.     4.1 Os2krnl.sym  /  OS/2 Warp 3
  46.  
  47.     4.2 Supported kernels by "-B"
  48.  
  49.  
  50.  
  51.     5.0 Bugreports
  52.  
  53.     5.1 Know bugs
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. 1.0  Warning/Disclaimer
  68.  
  69.  
  70.  
  71. We assume you have seen this before, but we have to make sure you are aware
  72.  
  73. that this piece of software is in an Alpha state. It may have serious bugs.
  74.  
  75. Since this runs at "ring-0" (kernel-mode or whatever you prefer) a bug
  76.  
  77. CAN CAUSE A SYSTEM HANG OR A SYSTEM HALT, and thus can cause loss of data. A
  78.  
  79. backup is hereby recommened.
  80.  
  81.  
  82.  
  83. WE ARE NOT REPONSIBLE FOR ANYTHING.
  84.  
  85.  
  86.  
  87. USE IT AT YOUR OWN RISKS!
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95. 2.0 Requirements
  96.  
  97.  
  98.  
  99. You will need another device driver, mwdd32.sys - v1.70. This may be found as
  100.  
  101. 32drv170.zip or in ext2_240.zip. This driver was made by Matthieu WILLM and
  102.  
  103. provides us with 32-bit driver support. (OS/2 drivers are mostly 16-bit.)
  104.  
  105. A lot of thanks goes to him!
  106.  
  107.   ftp://hobbes.nmsu.edu/pub/os2/system/drivers/filesys/ext2_240.zip
  108.  
  109.   ftp://hobbes.nmsu.edu/pub/os2/dev/drivers/32drv170.zip (?)
  110.  
  111.  
  112.  
  113. OS/2 Warp v4 (merlin)
  114.  
  115. or
  116.  
  117. OS/2 Warp v3 with os2krnl(r).sym see section 4.1
  118.  
  119. 32 MB of RAM.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. 3.0 Installation
  130.  
  131.  
  132.  
  133. A piece of advice:
  134.  
  135. Before you continue, it'd be wise to make sure you can boot to the command-
  136.  
  137. line; try Alt-F1 during boot, then either F2 or C (depending on the version).
  138.  
  139. If you need to fix any errors or if it doesn't boot, you'll need to edit the
  140.  
  141. file X:\os2\boot\config.x. You need a backdoor into your system!
  142.  
  143.  
  144.  
  145.  
  146.  
  147. 3.1 MWDD32.SYS
  148.  
  149.  
  150.  
  151. If you are running the ext2-os2 driver by Matthieu WILLM you may skip this
  152.  
  153. section.
  154.  
  155.  
  156.  
  157.  1) copy mwdd32.sys to x:\os2\boot (where x is your boot drive).
  158.  
  159.  2) add this line into your config.sys file:
  160.  
  161.        basedev=mwdd32.sys
  162.  
  163.  
  164.  
  165.  
  166.  
  167. 3.2 win32k.sys
  168.  
  169.  
  170.  
  171.  1) create a win32os2 directory in your x:\os2 directory.
  172.  
  173.  2) copy win32k.sys to it
  174.  
  175.  3) add this line to the end of the config.sys file:
  176.  
  177.        device=x:\os2\win32os2\win32k.sys
  178.  
  179.  
  180.  
  181. (It is a good idea to unzip the entire win32os2 zip-file into the
  182.  
  183. x:\os2\win32os2 directory and add it to the LIBPATH and SET PATH statements in
  184.  
  185. the config.sys file.)
  186.  
  187.  
  188.  
  189.  
  190.  
  191. 3.3 Options for win32k.sys
  192.  
  193.  
  194.  
  195. There are two groups of options for Win32k, one to spcify verbose/quiet,
  196.  
  197. logging,... and one to give system specifications. Near all of you could
  198.  
  199. easily ignore the last group (kernel options). (If you prefer the slash to
  200.  
  201. mark parameters, Win32k accepts both '/' and '-'.)
  202.  
  203.  
  204.  
  205. Win32k Accepts the following options:
  206.  
  207.     -Q[uiet]    no logo (bug? may not work)
  208.  
  209.     -L[ogging]  logging to com port
  210.  
  211.     -V[erbose]  logo during boot
  212.  
  213.     -C[1|2]     which com port you want to logg to. default: com2
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  Kernel Options:
  220.  
  221.   (These are about to become obsolete. See section 4.1 and 4.2)
  222.  
  223.     -B[uild]:xxxx
  224.  
  225.            - where xxxx is the build/revision number.
  226.  
  227.                      (try "ver /R" on the os/2 command-line)
  228.  
  229.  
  230.  
  231.     -K[erneltype]:A[strict]|H[strict]|R[etail]
  232.  
  233.            - select between the different debug and retail kernels.
  234.  
  235.  
  236.  
  237.     -S[MP] - toggels smp kernel.
  238.  
  239.     -U[NI] - toggels uni kernel.
  240.  
  241.  
  242.  
  243.  
  244.  
  245. 3.4 Finished
  246.  
  247.  
  248.  
  249. When 3.0-2.3 is read and done. You may reboot your machine, and hopfully it
  250.  
  251. boots fine. If it does, you will see a something like:
  252.  
  253.  
  254.  
  255. Win32k - Win32-OS/2 driver copyright (c) 1998 knut st. osmundsen
  256.  
  257.   Copyright 1998 Sander van Leeuwen (PE2LX code)
  258.  
  259.   Copyright 1997 Matthieu Willm (MWDD32)
  260.  
  261.         Found kernel: c:\os2krnl
  262.  
  263.         Build: 9030 - v20.40
  264.  
  265.  
  266.  
  267.         Found symbolfile: c:\os2\pdpsi\pmdf\warp4\os2krnlr.sym
  268.  
  269.         _ldrOpen          at 0xfff7827c
  270.  
  271.         _ldrRead          at 0xfff392e0
  272.  
  273.         _ldrClose         at 0xfff78c14
  274.  
  275.         _LDRQAppType      at 0xfff78c64
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283. PE-executable will now run just like other OS/2 programs.
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293. 4.0 About Win32k
  294.  
  295.  
  296.  
  297. Win32k is a device driver which implements a kind of loader for PE-files.
  298.  
  299. (PE-file == winNT/95 32-bit EXEs and DLLs). A loader is a operating system
  300.  
  301. part which reads a program (executable) and prepares it to be executed.
  302.  
  303.  
  304.  
  305.  
  306.  
  307. 4.1 Os2krnl.sym  /  OS/2 Warp 3
  308.  
  309.  
  310.  
  311. Win32k uses the .sym-file for the OS/2 kernel to get entrypoints and build
  312.  
  313. number of the running kernel.
  314.  
  315. They are searched for in the given order:
  316.  
  317.    <bootdrive>:\os2krnl.sym
  318.  
  319.    <bootdrive>:\os2\pdpsi\pmdf\warp4\os2krnlr.sym
  320.  
  321.    <bootdrive>:\os2\system\trace\os2krnl.sym
  322.  
  323.    <bootdrive>:\os2krnlr.sym
  324.  
  325.    <bootdrive>:\os2krnlh.sym
  326.  
  327.    <bootdrive>:\os2krnld.sym
  328.  
  329.  
  330.  
  331. Warp v4 has always distributed .sym files for retail, half-strict and all-strict
  332.  
  333. kernels with fixpacks. They are placed in <bootdrive>:\os2\pdpsi\pmdf\warp4\.
  334.  
  335.  
  336.  
  337. Warp 3 does not have a os2krnlr.sym file with its fixpack. It may be found on
  338.  
  339. the debugkernel disks. The Warp 3 SMP does have it included in the fixpack (in
  340.  
  341. the fix\os2.5 directory if is not copied).
  342.  
  343.  
  344.  
  345. Note! If you switch kernels, make sure that you don't mix-up .sym files! Don't
  346.  
  347. leave a build 9029 os2krnl.sym file when running a build 9030 kernel. It may
  348.  
  349. cause to hang or crash the system.
  350.  
  351.  
  352.  
  353.  
  354.  
  355. 4.2 Supported kernels by "-B"
  356.  
  357.  
  358.  
  359. First, don't use the -B option if you don't have to. That is, if you run OS/2
  360.  
  361. Warp v3 SMP and can't find the os2krnlr.sym file anywhere and you have tried
  362.  
  363. realy hard. Currently only build 8259 (fixpack 35?) is supported in SMP
  364.  
  365. edition.
  366.  
  367.  
  368.  
  369. ┌────────┬──────────┬────────────┬───────────────────────────────────────────┐
  370.  
  371. │ Build  │  Type    │ Processors │ Note                                      │
  372.  
  373. ├────────┼──────────┼────────────┼───────────────────────────────────────────┤
  374.  
  375. │ 9029   │ astrict  │    UNI     │ None                                      │
  376.  
  377. │ 9029   │ retail   │    UNI     │ Only US edition is tested.                │
  378.  
  379. │ 9030   │ astrict  │    UNI     │ None                                      │
  380.  
  381. │ 9030   │ retail   │    UNI     │ Only US edition is tested.                │
  382.  
  383. │ 8259   │ astrict  │    SMP     │ None                                      │
  384.  
  385. │ 8259   │ retail   │    SMP     │ Only US edition is tested.                │
  386.  
  387. │        │          │            │                                           │
  388.  
  389. │ all    │ all      │    both    │ all that provides a os2krnl.sym file      │
  390.  
  391. │        │          │            │                                           │
  392.  
  393. └────────┴──────────┴────────────┴───────────────────────────────────────────┘
  394.  
  395. Note: The -B option is obsolete. It may be removed by next relase. It is too
  396.  
  397.       much work to keep it all up-to-date.
  398.  
  399.  
  400.  
  401. Important! .sym-files currently overrides the -B option.
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409. 5.0 Bugreports
  410.  
  411.  
  412.  
  413. All bugs should be reported as described on the Win32-OS/2 home page.
  414.  
  415.  
  416.  
  417.  
  418.  
  419. 5.1 Know bugs
  420.  
  421.  
  422.  
  423. · The -q option may not work.
  424.  
  425. · Win32k is broke on Warp SMP.
  426.  
  427. · Terrible english. Sorry.
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437. Norway, the 14th September 1998.
  438.  
  439. knut st. osmundsen
  440.  
  441.  bird@solo.hib.no
  442.  
  443.  
  444.  
  445.