c_dkdel - Deletes a disk file

SYNTAX

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

int c_dkdel (filename)

     char               *filename;

PARAMETERS

filename (input, character, length(CMLEN))

Specifies the pathname of the file to be deleted.

DESCRIPTION

c_dkdel() deletes disk files. It was written specifically to delete disk files created by c_dkcre().

The file filename is deleted. If filename was a symbolic link, the file it pointed at is also deleted.

If filename does not exist, c_dkdel() returns a status of DISK_GONE.

RETURN VALUE

c_dkdel() returns

     E_SUCC (0)     --> successful completion
     E_FAIL (-1)    --> failure status
     DISK_GONE (-3) --> the specified file does not exist

SPECIAL CONSIDERATIONS

The caller must have enough privileges to delete the specified file.