en:docs:dos:api:int21:56

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

en:docs:dos:api:int21:56 [2021/05/02 08:37] – created prokusheven:docs:dos:api:int21:56 [2024/05/03 03:46] (current) – prokushev
Line 29: Line 29:
 ===== Notes ===== ===== Notes =====
  
- Notes: allows move between directories on same logical volume +allows move between directories on same logical volume 
- this function does not set the archive attribute + 
-   (see #01420 at AX=4301h), which results in incremental backups not +this function does not set the archive attribute (see #01420 at AX=4301h), which results in incremental backups not backing up the file under its new name 
-   backing up the file under its new name + 
- open files should not be renamed +open files should not be renamed 
- (DOS 2.x only) this function renames file by creating a new directory + 
-   entry with the new name, then marking the old entry deleted +(DOS 2.x only) this function renames file by creating a new directory entry with the new name, then marking the old entry deleted 
- (DOS 3.0+) allows renaming of directories + 
- (DOS 3.1+) wildcards are allowed if invoked via AX=5D00h, in which case +(DOS 3.0+) allows renaming of directories 
-   error 12h (no more files) is returned on success, and both source and + 
-   destination specs must be canonical (as returned by AH=60h). +(DOS 3.1+) wildcards are allowed if invoked via AX=5D00h, in which case error 12h (no more files) is returned on success, and both source and destination specs must be canonical (as returned by AH=60h). Wildcards in the destination are replaced by the corresponding char of each source file being renamed.  Under DOS 3.x, the call will fail if the destination wildcard is *.* or equivalent; under DR DOS 5.0, the call will fail with error code 03h if any wildcards are used. When invoked via AX=5D00h, only those files matching the attribute mask in CL are renamed. 
-   Wildcards in the destination are replaced by the corresponding char + 
-   of each source file being renamed.  Under DOS 3.x, the call will fail +under the FlashTek X-32 DOS extender, the old-name pointer is in DS:EDX and the new-name pointer is in ES:EDI (DS must equal ES) 
-   if the destination wildcard is *.* or equivalent; under DR DOS 5.0, + 
-   the call will fail with error code 03h if any wildcards are used. +BUG: (DR DOS 3.41) when invoked via AX=5D00h, this function will generate a new directory entry with the new name (including any wildcards) which can only be removed with a sector editor
-   When invoked via AX=5D00h, only those files matching the attribute +
-   mask in CL are renamed. +
- under the FlashTek X-32 DOS extender, the old-name pointer is in DS:EDX +
-   and the new-name pointer is in ES:EDI (DS must equal ES) +
-  BUG: (DR DOS 3.41) when invoked via AX=5D00h, this function will generate +
-   a new directory entry with the new name (including any wildcards) +
-   which can only be removed with a sector editor+
                      
 ===== See also ===== ===== See also =====
  
-  AH=17h,AX=4301h,AX=43FFh/BP=5053h,AX=5D00h,AH=60h,AX=7156h, AX=F257h/SF=04h+AH=[[en:docs:dos:api:int21:17|17h]],AX=[[en:docs:dos:api:int21:43:01|4301h]],AX=[[en:docs:dos:api:int21:43:ff|43FFh]]/BP=5053h,AX=[[en:docs:dos:api:int21:5d:00|5D00h]],AH=[[en:docs:dos:api:int21:60|60h]],AX=[[en:docs:dos:api:int21:71:56|7156h]]
  
 ===== Note ===== ===== Note =====