GN_Mov, Move a file

Owned by Elpekos
Last updated: May 01, 2018
2 min read

Register parameters

RST 20H, DEFW $8A09
IN: A   = reason code
          CM_TODIR  = $00, move file to a directory (keeping same filename)
          CM_TOFILE = $01, move file as new filename in optional different directory
    BHL = pointer to null-terminated source filename (B=0, local)
    CDE = pointer to a null-terminated destination directory or filename (C=0, local)
 
out, if successful:
        Fc = 0, file successfully moved
 
out, if failed:
        Fc = 1, unable to move file
        A = error code:
             RC_IVF, Invalid directory path name
             RC_USE, File in use
             RC_EXIS, File already exists
 
   registers changed after return:
        A.BCDEHL/IXIY  same
        .F....../....  different
  

Notes

  • API call implemented in OZ 5.0
  • If TODIR option is set, the destination path must be an existing directory.
  • If TOFILE option is set, source file (or directory) is renamed to target name. This name should be verified not to be already existing before.
  • This call is fast when files are on the same device because only file header (node) is moved.
  • When files are moved accross devices then a file copying followed by a file deletion are performed.

Related calls

GN_Cl, close file 
GN_Del, delete a file from memory
GN_Opf, open file/resource (wildcard search)
GN_Ren, rename file
GN_Cpy, copy file
OS_Fdp, fast sector-level duplicate of source file to target file 
OS_Cl, internal close (OZ usage) 
OS_Del, file delete (internal OZ usage) 
OS_Frm, file read miscellaneous 
OS_Fwm, file write miscellaneous 
OS_Gb, get byte from file (or device) 
OS_Gbt, get byte from file (or device) with timeout 
OS_Mv, move bytes between stream and memory 
OS_Op, internal open (OZ usage) 
OS_Pb, write byte to file, device 
OS_Pbt, write byte to file, device with timeout 
OS_Ren, file rename (internal OZ usage)

web analytics