c_dkfree - Frees reserved space on a given path

SYNTAX

#include     "las.h"
#include     "diskio.h"
int c_dkfree (path)

     char               *path;

PARAMETERS

path (input, character, length(CMLEN))

Specifies the pathname on which the software reserved space is to be freed.

DESCRIPTION

c_dkfree() frees the software reserved space from the disk reserve file for the specified pathname. The space is software reserved when disk files are created by c_dkcre().

RETURN VALUE

c_dkfree() returns

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

SPECIAL CONSIDERATIONS

When a file has been created by c_dkcre(), c_dkfree() must be called after the file has been closed to free the space in the disk reserve file. This will insure that the actual file size will be used to determine disk space available rather than the software reserved size.