Installation instructions

You will need a blank preformatted 1.44M 3.5" diskette to complete the
installation.

1. from the DOS prompt, unzip the alpha distribution into a temporary
directory.

e.g.

	C:\tmp>petros
	
	PKSFX (R)  FAST!!  Mini Self Extract Utility  Version 2.50  03-01-1999
	Copr. 1989-1999 PKWARE Inc. All Rights Reserved.
	PKSFX Reg. U.S. Pat. and Tm. Off.
	
	Searching EXE: C:\TMP\PETROS.EXE
	 Inflating: readme.txt
	 Inflating: license.txt
	 Inflating: INSTALL.EXE
	 Inflating: PETROS.IMG
	
	C:\tmp>

	You should have the following files.

	 Volume in drive C has no label
	 Volume Serial Number is 277E-14F7
	 Directory of C:\tmp

	.                      10-13-99  8:58p .
	..                     10-13-99  8:58p ..
	PETROS   EXE       105,550  10-14-99  6:38p PETROS.EXE
	README   TXT         5,589  10-13-99  9:34p README.TXT
	LICENSE  TXT         4,806  10-14-99  6:25p LICENSE.TXT
	INSTALL  EXE        27,435  10-14-99  6:27p INSTALL.EXE
	PETROS   IMG       240,640  10-14-99  6:38p PETROS.IMG
	         5 file(s)        384,020 bytes
	         2 dir(s)      12,906,496 bytes free

2. Place your blank preformatted diskette in drive A:

3. Execute the program INSTALL.EXE and follow the installation instructions.

4. Your diskette should now be ready to boot PetrOS(tm) and should look
   something similar to this.


         Volume in drive A has no label
         Directory of A:\

        BOOTSTUB BIN         8,096  03-05-00  4:56p
        KERNEL   KEX       151,552  03-05-00 11:06p
        EXECUSR  EXE        28,672  03-05-00 11:03p
        V86      EXE        57,344  03-05-00 11:04p
        SHELL    EXE        45,056  03-05-00 11:03p
        AUTOEXEC CMD           208  03-05-00 10:46p
        ED       EXE        45,056  03-05-00 11:03p
        PM       EXE        17,488  03-05-00 11:03p
        WSOCK32  DLL        53,248  03-05-00 11:03p
        TCPIP    SYS        86,016  03-05-00 11:06p
        TCPIP    CFG           516  03-05-00 10:42p
        NE_DRV   SYS        24,576  03-05-00 11:06p
        DEC_DRV  SYS        24,576  03-05-00 11:06p
        PING     EXE        28,672  03-05-00 11:04p
        NETSTAT  EXE        24,576  03-05-00 11:04p
        TELNET   EXE        36,864  03-05-00 11:04p
                16 file(s)        632,516 bytes
                 0 dir(s)         823,808 bytes free


5. Leave the diskette in the drive and restart your machine. (ctrl-alt-del)

6. If all goes well, PetrOS(tm) will boot up and is ready to execute 
   commands from the shell.

7. To reboot, type ctrl-D or "exit" from the shell prompt.  It will cause the
   shell to close resulting in the kernel closing down and a system reboot.

NOTE: ctrl-sysrq is a special command to invoke the built in debugger.  
If you hit this by mistake, press  to leave.

APPENDIX A

Files on boot disk.

BOOTSTUB.BIN	- secondary boot loader
BOOTSTUB.EXE	- an alternative boot loader runnable from DOS
		  (same as BOOTSTUB.BIN)
KERNEL.KEX	- the PetrOS(tm) kernel
EXECUSR.EXE	- user mode executable loader
SHELL.EXE	- the sample shell program
PM.EXE          - a DOS mode boot loader that coexists
                  with Smartdrive and HIMEM.SYS

Other files     - see web site http://petros-project.com/


APPENDIX B

List of shell commands.

Standard commands.


	executes a program

exit
	leave the shell (reboots system)

cd  or 
	change directory

ls 
	list the directory (options are -l and -R) wildcards are allowed. 
	(use ctrl-break to cancel listing)

mv  
	rename a file or directory

rm 
	remove a file

cat 
	list a file
	(use ctrl-break to cancel listing)


load 
	load a device driver
unload 
	unload a device driver
drivers
	display a list of device drivers loaded

debug	
	execute a program with the debugger.

bg	
	start a program in the background

ps
	display a list of active processes and threads.
ver
	display the version number

kill	

	kill process/thread with a particular process ID.


Some testing commands for diagnostics (only in alpha/beta version - USE WITH CARE)

scan	
	copy any file from disk to null device. 
	useful for testing speed of file access.
display
	toggle the display of files/directories.
	useful for testing speed of directory scanning.
tracedir
	toggles display of diagnostic information on directory listings.

loop	
	repeatedly executes a program until key pressed
bgloop	
	repeatedly executes a program in the background until key pressed. 
	USE WITH CARE AS IT WILL USE AS ALL AVAILABLE SYSTEM RESOURCES.
thread 
	an internal test of threading within the shell.
dumpfree
	dumps the kernel heap free list.
dumppage
	dumps the kernel page list.