Apple-2-SW
/
A2osX
mirror of https://github.com/A2osX/A2osX.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update docs

This commit is contained in:
Patrick Kloepfer 2019-03-18 21:11:03 -04:00
parent c29c556af8
commit 5d1012a680
4 changed files with 150 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

99
.Docs/.HELLOWORLD.S.txt Normal file
View File

@ -0,0 +1,99 @@
NEW
PREFIX
AUTO 4,1 Enable MASM3 auto line num
.LIST OFF
.OP 65C02 Target CPU, must = CPU header level
.OR $2000 usualy $2000, any value > $100 ok
.TF ROOT/HELLOWORLD
*--------------------------------------
.INB INC/MACROS.I
.INB INC/A2OSX.I
*--------------------------------------
* Zero Page Segment, up to 32 bytes
*--------------------------------------
.DUMMY
.OR ZPBIN
ZS.START
* MyPtr .BS 2
ZS.END .ED
*--------------------------------------
* File Header (16 Bytes)
*--------------------------------------
CS.START cld
jmp (.1,x)
.DA #$61 6502,Level 1 (65c02)
.DA #1 BIN Layout Version 1
.DA #0 S.PS.F.EVENT
.DA #0
.DA CS.END-CS.START Code Size (without Constants)
.DA DS.END-DS.START Data SegmentSize
.DA #16 Stack Size
.DA #ZS.END-ZS.START Zero Page Size
.DA 0
*--------------------------------------
* Relocation Table
*--------------------------------------
.1 .DA CS.INIT
.DA CS.RUN
.DA CS.DOEVENT
.DA CS.QUIT
* Add any address you want be relocated by loader
* Usefull if you have to pass EFFECTIVE address to an API call...
L.MSG.HELLO .DA MSG.HELLO
.DA 0
*--------------------------------------
* Called once at process creation
* Put code for loading LIB here
*--------------------------------------
CS.INIT clc
rts
*--------------------------------------
* Called until exit with CS
* if RUN exits with CC, RN entered again
*--------------------------------------
CS.RUN
* Put your code here
>LDYA L.MSG.HELLO
>SYSCALL puts
.8 lda #0 Exit Code = Succes
sec QUIT Process
rts
.9 lda #E.SYN Exit Code = Succes
sec QUIT Process
rts
*--------------------------------------
* Called if option S.PS.F.EVENT enabled in Header
* Timer Event : every 10th seconds
*--------------------------------------
CS.DOEVENT sec
rts
*--------------------------------------
* Called once, when RUN exited with CS
* Put code for unloading LIB here
*--------------------------------------
CS.QUIT clc
rts
*--------------------------------------
CS.END
*--------------------------------------
* Initialized DATA
*--------------------------------------
* Put your constant here :
MSG.HELLO .AZ "Hello World"
*--------------------------------------
* Per Process DATA segement (0 filled before INIT)
*--------------------------------------
.DUMMY
.OR 0
DS.START
DS.END
.ED
*--------------------------------------
MAN
SAVE ROOT/HELLOWORLD.S Save this source file
ASM

100
.Docs/Technical Spec.md
View File

@ -1,27 +1,27 @@
# A2osX (0.92) Multi-Tasking OS for Apple II # A2osX (0.92) Multi-Tasking OS for Apple II
This is the functional specification for A2osX, its system modules, internal and external commands and shell language. Please refer to the other A2osX documentation such as the User Guide, Notes for Developers and Shell Programming Guide for more information. This is the functional specification for A2osX and its system modules, internal and external commands and shell language. Please refer to the other A2osX documentation such as the User Guide, Notes for Developers and Shell Programming Guide for more information.
## SYS/KM* Supported Hardware At Kernel Level (ProDOS): ## SYS/KM* Supported Hardware At Kernel Level (ProDOS):
| KM.Name | Status | Comment | | KM.Name | Status | Comment | K.Ver |
| ------- | ------ | ------- | | ------- | ------ | ------- | ------|
| KM.APPLETALK | Working | AppleTalk Support for ProDOS | | KM.APPLETALK | Working | AppleTalk Support for ProDOS | 0.92 |
| KM.NSC | Working | No-Slot-Clock/DS1216E | | KM.NSC | Working | No-Slot-Clock/DS1216E | 0.92 |
| KM.RAMWORKS | Working | AE-Ramworks I,II,III | | KM.RAMWORKS | Working | AE-Ramworks I,II,III | 0.92 |
| KM.VSDRIVE | Working | ADTPro Virtual Drive for SSC | | KM.VSDRIVE | Working | ADTPro Virtual Drive for SSC | 0.92 |
## SBIN,Daemons/Commands: ## SBIN,Daemons/Commands:
| Name | Status | Comment | K.Ver | | Name | Status | Comment | K.Ver |
| ---- | ------ | ------- | ------| | ---- | ------ | ------- | ------|
| DHCPCLNT| Working | rewritten to use new Socket API | 0.92 | | DHCPCLNT| Working | rewritten to use new Socket API | 0.92 |
| GETTY | Working | -E : Exit on remote close | 0.92 | | GETTY | Working | -E : Exit on remote close | 0.93 |
| HTTPD | In Progress | | 0.9 | | HTTPD | In Progress | | 0.9 |
| INSDRV | Working | | 0.92 | | INSDRV | Working | | 0.93 |
| KCONFIG | Working | Kernel Configuration Utility | 0.92 | | KCONFIG | Working | Kernel Configuration Utility | 0.93 |
| LOGIN | In Progress | no auth using /etc/passwd yet | 0.92 | | LOGIN | In Progress | no auth using /etc/passwd yet | 0.93 |
| SHELL | Working | (See Internal Shell commands) | 0.92 | | SHELL | Working | (See Internal Shell commands) | 0.93 |
| TCPIPD | Working | ARP,IP,ICMP,UDP & TCP ok | 0.92 | | TCPIPD | Working | ARP,IP,ICMP,UDP & TCP ok | 0.92 |
| TELNETD | Working | | 0.92 | | TELNETD | Working | | 0.92 |
@ -110,46 +110,46 @@ note : '$VAR' does NOT expand Variable
| Uther2.AI.DRV | In Progress | With ARP/IP Offloading | 0.92 | | Uther2.AI.DRV | In Progress | With ARP/IP Offloading | 0.92 |
## BIN,External Shell commands: ## BIN,External Shell commands:
| Name | Status | Comment | | Name | Status | Comment | K.Ver |
| ---- | ------ | ------- | | ---- | ------ | ------- | ----- |
| CAT | Working | -A : Show All non printable caracters <br> -N : Number all output lines <br> -S : Suppress repeated empty output lines | | CAT | Working | -A : Show All non printable caracters <br> -N : Number all output lines <br> -S : Suppress repeated empty output lines | 0.93 |
| CUT | Working | CUT \<opt\> "line" or CMD\|CUT \<opt\> <br> -H : This help screen <br> -F nn : Output field nn <br> -M nn : Output starting at nn <br> -N nn : Output Ending at nn <br> -S ch : Change default SPACE separator to 'ch' | | CUT | Working | CUT \<opt\> "line" or CMD\|CUT \<opt\> <br> -H : This help screen <br> -F nn : Output field nn <br> -M nn : Output starting at nn <br> -N nn : Output Ending at nn <br> -S ch : Change default SPACE separator to 'ch' | 0.93 |
| CHGRP | In Progress | -C : Continue On Error <br> -R : Recurse subdirectories | | CHGRP | In Progress | -C : Continue On Error <br> -R : Recurse subdirectories | - |
| CHMOD | In Progress | -C : Continue On Error <br> -R : Recurse subdirectories | | CHMOD | In Progress | -C : Continue On Error <br> -R : Recurse subdirectories | - |
| CHOWN | In Progress | -C : Continue On Error <br> -R : Recurse subdirectories | | CHOWN | In Progress | -C : Continue On Error <br> -R : Recurse subdirectories | - |
| CHTYP | Working | -C : Continue On Error <br> -R : Recurse subdirectories | | CHTYP | Working | -C : Continue On Error <br> -R : Recurse subdirectories | 0.92 |
| CP | Working | -C : Continue On Error <br> -Q : Quiet <br> -R : Recurse subdirectories <br> -Y : Dont't Prompt For Override | | CP | Working | -C : Continue On Error <br> -Q : Quiet <br> -R : Recurse subdirectories <br> -Y : Dont't Prompt For Override | 0.93 |
| EDIT | Working | still missing : find/replace | | EDIT | Working | still missing : find/replace | 0.93 |
| FORMAT | In Progress | FORMAT \<BLOCKDEV\> [VOLUME.NAME] <br> -L : Low-Level Format *not currently supported <br> -1..9 : Catalog Size (block count) | | FORMAT | In Progress | FORMAT \<BLOCKDEV\> [VOLUME.NAME] <br> -L : Low-Level Format *not currently supported <br> -1..9 : Catalog Size (block count) | 0.92 |
| GREP | Working | GREP \<opt\> PATTERN FILE or CMD\|GREP \<opt\> PATTERN <br> -H : This help screen <br> -I : Ignore Case <br> -N : Print line Number | | GREP | Working | GREP \<opt\> PATTERN FILE or CMD\|GREP \<opt\> PATTERN <br> -H : This help screen <br> -I : Ignore Case <br> -N : Print line Number | 0.93 |
| KILL | Working | KILL \<signal\> PID <br> -0 : No Signal <br> -1 : SIGQUIT | | KILL | Working | KILL \<signal\> PID <br> -0 : No Signal <br> -1 : SIGQUIT | 0.93 |
| LS | Working | -A : Print . & .. <br> -C : Single column listing <br> -F : Single column, includes full path <br> -L : long listing with size/date... <br> -R : Recurse subdirectories | | LS | Working | -A : Print . & .. <br> -C : Single column listing <br> -F : Single column, includes full path <br> -L : long listing with size/date... <br> -R : Recurse subdirectories | 0.93 |
| LSDEV | Working | Dump device Drivers | | LSDEV | Working | Dump device Drivers | 0.93 |
| LSOF | Working | List Open Files | | LSOF | Working | List Open Files | 0.93 |
| MD5 | Working | MD5 \[ -D : String \| file \] | | MD5 | Working | MD5 \[ -D : String \| file \] | 0.93 |
| MEM | Working | Old dump behavior is now MEMDUMP. New MEM command displays MEMSTAT (Main, Aux & Kernel Memory) | | MEM | Working | Old dump behavior is now MEMDUMP. New MEM command displays MEMSTAT (Main, Aux & Kernel Memory) | 0.93 |
| MKDIR | Working | Make Directory| | MKDIR | Working | Make Directory| 0.93 |
| MORE | Working | MORE \<File\> or CMD\|MORE \<opt\> <br> -H : This help screen <br> -N : Number all output lines <br> -P : Page mode, no scroll <br> -S : Process ESC codes | | MORE | Working | MORE \<File\> or CMD\|MORE \<opt\> <br> -H : This help screen <br> -N : Number all output lines <br> -P : Page mode, no scroll <br> -S : Process ESC codes | 0.93 |
| NSCUTIL | Working | NSCUTIL DD/MM/YY,hh:mm:ss <br> Tool for setting time in NSC/DL1216E | | NSCUTIL | Working | NSCUTIL DD/MM/YY,hh:mm:ss <br> Tool for setting time in NSC/DL1216E | 0.92 |
| MV | Working | -C : Continue On Error <br> -Q : Quiet <br> -R : Recurse subdirectories <br> -Y : Dont't Prompt For Override | | MV | Working | -C : Continue On Error <br> -Q : Quiet <br> -R : Recurse subdirectories <br> -Y : Dont't Prompt For Override | 0.93 |
| PS | Working | List Processes| | PS | Working | List Processes| 0.93 |
| RM | Working | RM \[File/Dir, *,? wildcards allowed\] <br> -C : Continue On Error <br> -Q : Quiet <br> -R : Recurse subdirectories | | RM | Working | RM \[File/Dir, *,? wildcards allowed\] <br> -C : Continue On Error <br> -Q : Quiet <br> -R : Recurse subdirectories | 0.93 |
## Network (TCPIP) tools: ## Network (TCPIP) tools:
| Name | Status | Comment | | Name | Status | Comment | K.Ver |
| ---- | ------ | ------- | | ---- | ------ | ------- | ----- |
| ARP | Working | dump ARP cache, setup a static ARP entry | | ARP | Working | dump ARP cache, setup a static ARP entry | 0.92 |
| DNSINFO | Working | dump DNS cache, setup a static DNS entry | | DNSINFO | Working | dump DNS cache, setup a static DNS entry | 0.92 |
| HTTPGET | In Progress | HTTPGET <ip\|host> [port] <br> -U Url <br> -F UrlFile | | HTTPGET | In Progress | HTTPGET <ip\|host> [port] <br> -U Url <br> -F UrlFile | 0.92 |
| IPCONFIG | Working | -D : Try to get IP address from DHCP <br> -E : Read ETC files <br> -S : Set/Reset TCPIP configuration (-E, then -D if required) | | IPCONFIG | Working | -D : Try to get IP address from DHCP <br> -E : Read ETC files <br> -S : Set/Reset TCPIP configuration (-E, then -D if required) | 0.92 |
| NETSTAT | Working | Display socket status | | NETSTAT | Working | Display socket status | 0.92 |
| PING | Working | PING <ip\|host> <br> -1..9 : Ping Count | | PING | Working | PING <ip\|host> <br> -1..9 : Ping Count | 0.92 |
| TELNET | Working | TELNET <ip\|host> [port] | | TELNET | Working | TELNET <ip\|host> [port] | 0.92 |
## DEV tools: ## DEV tools:
| Name | Status | Comment | | Name | Status | Comment | K.Ver |
| ---- | ------ | ------- | | ---- | ------ | ------- | ----- |
| ASM | In Progress | S-C MASM based multi CPU assembler | | ASM | In Progress | S-C MASM based multi CPU assembler | - |
| MEMDUMP | Working | Tool to track memory leak| | MEMDUMP | Working | Tool to track memory leak| 0.93 |
| RPCDUMP | In Progress | Tool based on UDP socket API, renamed from RPCINFO <br> RPCDUMP <ip\|host> | | | RPCDUMP | In Progress | Tool based on UDP socket API, renamed from RPCINFO <br> RPCDUMP <ip\|host> | 0.92 |

BIN
.Floppies/A2OSX.MAKE.po
View File

Binary file not shown.

1
ADMIN/LISTUSERS.txt
View File

@ -68,6 +68,7 @@ FOR F IN `CAT ${ROOT}ETC/PASSWD`
SET LINE = $LINE + 1 SET LINE = $LINE + 1
NEXT NEXT
ECHO ECHO
ECHO
ECHO "PRESS RETURN" ECHO "PRESS RETURN"
PAUSE PAUSE
MAN MAN