SYNTAX

#include      "las.h"
#include      "diskio.h"

     char               *from
     char               *to
     char               directories[][CMLEN];

PARAMETERS

from (input, character, length(CMLEN))

Specifies the path/name of the file to be moved.

to (input, character, length(CMLEN))

Specifies the path/name of the output file.

directories (input, character, length(CMLEN))

Specifies a list of pathnames for directories to be searched for available space.

DESCRIPTION

c_dkmove() moves disk files. It was written specifically to move disk files created by c_dkcre().

c_dkmove() uses the same algorithms to select a directory and allocate the file as c_dkcre(). From is moved and the file to becomes a symbolic link to the actual file. If from is a symbolic link, the file it points to is moved and the symbolic link to is updated to point at the new file.

RETURN VALUE

c_dkmove() returns

     E_SUCC (0)  --> successful completion
     E_FAIL (-1) --> failure status

SPECIAL CONSIDERATIONS

The caller must have write access to all specified directories.

Allocating the file is extremely slow through NFS.

A single file is not allowed to span multiple directories, file systems, or disk drives.

The size of the disk file that can be created with this function is limited to the precision of a long integer (i.e., 2,147,483,647 bytes) or the size of the file system, whichever is smaller.