pSOSystem System Calls - Read

pHILE+ System Calls remove_f
remove_f Deletes a file.
#include
unsigned long remove_f(
char *name /* pathname */
)
Volume Types
Description
Arguments
Return Value
Error Codes
All volume types, except CD-ROM; however, functional differences exist and are
described here.
remove_f() deletes a file from a volume. The file can be an ordinary file or a
directory file. All storage used by the file is returned to the system for reuse. The
file's entry in its parent directory is also deleted.
System files and non-empty directory files cannot be deleted. On pHILE+ and
MS-DOS formatted volumes, an open file cannot be deleted. An open file can be
deleted on an NFS volume. CD-ROM volumes are read-only.
name Points to the null-terminated pathname of the file to delete.
This system call returns 0 on success or an error code on failure.
Hex Mnemonic Description
0x2003 E_BADVOL Inconsistent data on volume; volume
corrupted.
0x200A E_DMOUNT Volume not mounted.
0x200B E_FNAME Filename not found.
pSOSystem System Calls 2-101
2