| PsiFS_AsyncStart (SWI &520C5) | |||||||||||||||
| Start an asynchronous remote operation | |||||||||||||||
| On entry: | R0 = | reason code | |||||||||||||
| Other registers depend on reason code | |||||||||||||||
| On exit: | R0 = | handle for the operation | |||||||||||||
| Interrupts: | Interrupt status is undefined Fast interrupts are enabled | ||||||||||||||
| Processor mode: | Processor is in SVC mode | ||||||||||||||
| Re-entrancy: | SWI is not re-entrant | ||||||||||||||
| Use: |
This call starts an asynchronous remote operation, depending on the reason code in R0. Valid reason codes are:
These operations may only be performed if the remote link is enabled and a connection has been established. If a connection has not been established, then the operation will complete with an error status. Any PsiFS file names supplied as parameters must be of the form :drive.$.file/directory where drive is a single character drive letter (A to Z), and file/directory is the path to the object. Other file names may be specified in any convenient form, although use of canonicalised paths is recommended. | ||||||||||||||
| Related SWIs: | PsiFS_AsyncEnd, PsiFS_AsyncPoll, PsiFS_AsyncControl | ||||||||||||||
| Related vectors: | None | ||||||||||||||
| PsiFS_AsyncStart 0 (SWI &520C5) | |||
| Close the specified open files | |||
| On entry: | R0 = | 0 | |
| R1 = | pointer to control-character terminated pattern to match (0 for none) | ||
| R2 = | pointer to control-character terminated file name | ||
| R3 = | append to end of file (0 overwrites) | ||
| On exit: | R0 = | handle for the operation | |
| Use: | Close all tasks with open files that match the specified wildcarded pattern. If no pattern is specified then all tasks are closed. A list of the files closed is written to the specified file in a suitable format for subsequently restarting the tasks. | ||
| PsiFS_AsyncStart 1 (SWI &520C5) | |||
| Open the specified files | |||
| On entry: | R0 = | 1 | |
| R1 = | pointer to control-character terminated file name | ||
| R2 = | delete file when finished (0 leaves it) | ||
| On exit: | R0 = | handle for the operation | |
| Use: | Restart the tasks listed in the specified file. Each line of the file should contain two file names separated by a space; the first is the application to start, and the second file is the file to open. If an application should be started without opening a file then the second file name should be left blank, but the space must still be included. | ||
| PsiFS_AsyncStart 2 (SWI &520C5) | |||
| Read a single file | |||
| On entry: | R0 = | 2 | |
| R1 = | pointer to control-character terminated source file name | ||
| R2 = | pointer to control-character terminated destination file name | ||
| On exit: | R0 = | handle for the operation | |
| Use: | Read the specified file from the SIBO or EPOC device. | ||
| PsiFS_AsyncStart 3 (SWI &520C5) | |||
| Write a single file | |||
| On entry: | R0 = | 3 | |
| R1 = | pointer to control-character terminated source file name | ||
| R2 = | pointer to control-character terminated destination file name | ||
| R3 = | delete file when finished (0 leaves it) | ||
| On exit: | R0 = | handle for the operation | |
| Use: | Write the specified file to the SIBO or EPOC device. | ||
| PsiFS_AsyncStart 4 (SWI &520C5) | |||
| Backup a single directory tree | |||
| On entry: | R0 = | 4 | |
| R1 = | pointer to control-character terminated source directory | ||
| R2 = | pointer to control-character terminated destination backup file name | ||
| R3 = | pointer to control-character terminated previous backup file name (0 for none) | ||
| R4 = | pointer to control-character terminated scrap backup file name (0 for none) | ||
| R5 = | pointer to control-character terminated temporary file name | ||
| On exit: | R0 = | handle for the operation | |
| Use: | Perform a backup of all files starting from the specified SIBO or EPOC directory. The output is written to a tar file to preserve long filenames, using the fltar (Archie) extensions to store datestamp and attribute information. If a previous backup file is specified then unmodified files are simply copied rather than being retrieved from the SIBO or EPOC device. If a scrap backup file is also specified then files not used from the previous backup file are copied to keep a record of previous versions. | ||
| [Contents] [Up] | Copyright © Alexander Thoukydides, 1998, 1999, 2000 |