OSWORD &14

From BeebWiki
Revision as of 00:49, 22 February 2021 by Jgharston (talk | contribs) (Added notes)
Jump to: navigation, search
OSWORD &14 (20) - Various Network functions
XY?0=0 - Communicate with fileserver
XY?0=1 - Send text string to remote station
XY?0=2 - Generate error on remote machine.

XY?0=0 - Communicate with fileserver

On entry:
 XY?0=0
 XY?1=size of rest of block
 XY?2=0
 XY?3=function
 XY?4=0
 XY?5=0
 XY?6=0
 XY+7... contains rest of infomation
On exit:
 XY?1=updated size of block
 XY?2=command code, 0 for ok <>0 to continue with another function
 XY?3=error code, 0 for ok <>0 for error, CR-terminated error
      string at XY+4
 XY+4.. contains returned data.

XY?0=1 - Send text string to remote station

On entry:
 XY?0   =1
 XY+1..2=destination station
 XY+3... string to send, terminated by CR or &00. The CR also gets
       sent.

XY?0=2 - Generate error on remote machine

On entry:
 XY?0   =2
 XY+1..2=destination machine.

Notes

On RISC OS and Arthur OSWORD &14 calls SWI "NetFS_DoFSOp", but if you call NetFS_DoFSOp directly the control block is passed and returned differently.

 OSWORD &14,0:
        XY+00 01 02 03 04 05 06 07 08 09...
 Send:    |00|sz|00|fn|00|00|00|command data...
 Receive: |  |  |ok|er|returned data...
 
 NetFS_DoFSOp:
        R1+00 01 02 03 04 05 06 07 08 09...
 Send:    |command data...
 Receive: |er|returned data...

See Also

Networking calls

Jgharston 13:27, 26 May 2009 (UTC)