FilerAction_SendStartOperation
Filer_Action
» SWI Calls
» FilerAction_SendStartOperation
FilerAction_SendStartOperation
(SWI &40F82)
| Entry | |
|---|---|
| R0 | Task handle to which to send the message |
| R1 | Reason code (as described below) |
| R2 | Option bits (as described below) |
| R3 | Pointer to operation specific data (see use cases below) |
| R4 | Length of operation specific data (see use cases below) |
| Exit | |
|---|---|
| - | - |
Reason Codes
| # | Action |
|---|---|
| 0 | Copy |
| 1 | Move (rename) |
| 2 | Delete |
| 3 | Set access |
| 4 | Set type |
| 5 | Count |
| 6 | Move (copy then delete original) |
| 7 | Copy local (within same directory) |
| 8 | Stamp files |
| 9 | Find File |
Option Bits
| Bit | Meaning when set |
|---|---|
| 0 | Verbose |
| 1 | Confirm |
| 2 | Force |
| 3 | Newer (as opposed to just Look) |
| 4 | Recurse (only applies to access) |
Use Cases
| Copy: Reason Code = 0 | |
|---|---|
| Entry | |
| R3 | Pointer to name of destination directory (null terminated) |
| R4 | Length of name of destination directory (including null terminator) |
| Move: Reason Code = 1 | |
|---|---|
| Entry | |
| R3 | Pointer to name of destination directory (null terminated) |
| R4 | Length of name of destination directory (including null terminator) |
| Delete: Reason Code = 2 | |
|---|---|
| Entry | |
| R3 | Unused |
| R4 | 0 |
| Set access: Reason Code = 3 | |
|---|---|
| Entry | |
| R3 | Pointer to word containing required new access: |
| Bottom two bytes indicate the values to set | |
| Top two bytes flag which bits are to be left alone | |
| R4 | 4 |
| Set type: Reason Code = 4 | |
|---|---|
| Entry | |
| R3 | Pointer to word containing new type in bits 0-11 |
| R4 | 4 |
| Count: Reason Code = 5 | |
|---|---|
| Entry | |
| R3 | Unused |
| R4 | 0 |
| Copy Move: Reason Code = 6 | |
|---|---|
| Entry | |
| R3 | Pointer to name of destination directory (null terminated) |
| R4 | Length of name of destination directory (including null terminator) |
| Copy Local: Reason Code = 7 | |
|---|---|
| Entry | |
| R3 | Pointer to name of destination name (null terminated) |
| R4 | Length of name of destination name (including null terminator) |
| Stamp: Reason Code = 8 | |
|---|---|
| Entry | |
| R3 | Unused |
| R4 | 0 |
| Find: Reason Code = 9 | |
|---|---|
| Entry | |
| R3 | Pointer to name of object to Find (null terminated) |
| R4 | Length of name of object to find (including null terminator) |
Use
The purpose of this call is to send a message containing information to start operation.
Notes
This SWI sends any remaining leafnames with Message_FilerAddSelection, then starts the selected operation by constructing and sending Message_FilerAction.
Reason dependent data is always a pointer, even for word sized data. Usually the data is a destination pathname.
See also
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.