pSOSystem System Calls - Read

move_f pHILE+ System Calls
move_f Moves (renames) a file.
#include
unsigned long move_f(
char *oldname, /* old pathname */
char *newname /* new pathname */
)
Volume Types
Description
Arguments
All volume types, except CD-ROM; however, some behavioral differences exist and
are described here.
move_f() changes the pathname associated with a file.
With one exception, the pHILE+ file system manager can move both ordinary and
directory files on all volume types. The exception is directory files on MS-DOS
formatted volumes, which cannot be moved. When a directory is moved, the
directory and all files in the directory's subtree are moved.
Conceptually, move_f() moves a file by changing control structures on the volume
(but no actual movement of data ever occurs). Therefore, oldname and newname
must be on the same volume.
oldname Points to the null-terminated old pathname.
newname Points to the null-terminated new pathname.
If oldname and newname are in the same directory, move_f() simply renames the
file. Otherwise, move_f() has the effect of moving the file to a different location
within the volume's directory tree. move_f() does not change the size or contents of
the file.
move_f() fails if newname already exists or if the move operation would create a
non-tree directory organization (for example, when a directory file is moved to its
own subtree.)
2-70 pSOSystem System Calls