Name
file_unlink — Delete a file from the file system
Synopsis
file_unlink
(
|
in
path
varchar
); |
Description
This function requires dba privileges.
This function deletes a file from the file system. sys_unlink is a synonym of this function.
Parameters
path
Path name of the file to delete.
Return Types
On success returns zero. Otherwise signals an error.
Errors
Table 24.35. Errors signalled by
| SQLState | Error Code | Error Text | Description |
|---|---|---|---|
| 42000 | FA003 | Access to %s is denied due to access control in ini file | |
| 42000 | FA004 | Access to %s is denied due to access control in ini file | |
| 42000 | SR426 | Permission is denied for the file '%s' in sys_unlink() | |
| 42000 | SR427 | Path name '%s' too long in sys_unlink() | |
| 42000 | SR428 | A directory component in '%s' does not exist or is a dangling symbolic link in sys_unlink() | |
| 42000 | SR429 | A component used as a directory in '%s' is not, in fact, a directory in sys_unlink() | |
| 42000 | SR430 | '%s' refers to a directory in sys_unlink() | |
| 42000 | SR431 | Insufficient kernel memory was available in sys_unlink() | |
| 42000 | SR432 | '%s' refers to a file on a read-only filesystem in sys_unlink() | |
| 42000 | SR433 | Too many symbolic links were encountered in translating '%s' in sys_unlink() | |
| 42000 | SR434 | An I/O error occurred in sys_unlink() |