h6. [[OS SWI Calls]] h6(. » [[OS_FSControl]] h6((. » OS_FSControl 25 h2. OS_ FSControl 25 h5. (SWI &29) |_<^{width:4em}. Entry | | |<^. R0 |<^. 25 (&19) | |<^. R1 |<^. Pointer to original filename | |<^. R2 |<^. Pointer to new filename | |_<^{width:4em}. Exit | | |<^. R0 |<^. Preserved | |<^. R1 |<^. Preserved | |<^. R2 |<^. Preserved | h4. Use The purpose of this call is to rename a file. h4. Notes It can only rename objects to new names on the same filing system and disc - otherwise use perform a move, followed by a delete operation (see [[OS_FSControl 26]]. There is no SWI to discover which disc a given file is on - hence it is impossible to ascertain whether this SWI will fail without actually calling it. h4. See also * [[OS_FSControl]] * [[OS_FSControl 26]]