PsiFS: SWI Calls

PsiFS_AsyncPoll

PsiFS_AsyncPoll
(SWI &520C7)

Poll the status of an asynchronous remote operation

On entry: R0 = the previously allocated handle for this operation

On exit: R0 = status of the operation

R1 = pointer to null terminated description of status

R2 = pointer to null terminated details, or 0 if none

R3 = pointer to null terminated error text, or 0 if none

R4 = operational time taken in centi-seconds

R5 = estimated time to complete operation in centi-seconds, or 0 if no estimate available

Interrupts: Interrupt status is undefined
Fast interrupts are enabled

Processor mode: Processor is in SVC mode

Re-entrancy: SWI is not re-entrant

Use:

Poll the status of a previously started asynchronous remote operation. The possible values for the status are:

Value	Meaning	Description
&0000	completed successfully	The operation has terminated
&0001	completed with error
&0002	aborted
&0100	operation starting	Internal status codes; these should not normally be returned
&0101	operation in progress
&0102	operation delegated
&0200	about to copy a file: waiting for yes or no	A response is required via `PsiFS_AsyncControl` to continue the operation
&0201	file failed to open: waiting for skip or retry
&0202	previous backup contains newer file: waiting for skip, copy or quiet
&0202	file failed to read: waiting for skip or retry
&0300	operation paused	The operation should be resumed using `PsiFS_AsyncControl`
&1000	reading list of open files	The operation is progressing; the status code and description indicates the current activity
&1001	reading command line for an open file
&1002	closing a task
&1003	opening a task
&1100	opening a file
&1101	closing a file
&1102	reading from a file
&1103	writing to a file
&1104	creating a directory
&1105	deleting a file
&1200	reading catalogue entry
&1201	writing catalogue entry
&1300	keeping file from previous backup
&1301	scrapping file from previous backup
&1302	skipping over file from previous backup
&1303	adding file to backup
&1304	extracting file from backup

The description pointed to be R1 is a summary of the current status (typically the operation being performed), or the question that requires a response. The details optionally pointed to by R2 is typically set to the name of the file or application being operated upon. Any error message or additional details of a problem are pointed to by R3.

The returned pointers only remain valid until the next call of this SWI. If the values need to be kept then they must be copied immediately.

The timings returned in R4 and R5 are estimates for guidance only; they are unlikely to be particularly accurate.

Related SWIs: PsiFS_AsyncStart, PsiFS_AsyncEnd, PsiFS_AsyncControl

Related vectors: None

[Contents] [Up]