shithub: purgatorio

ref: 8a788aea84aad3bfbd5b39d78c1925654f3b9e14
dir: purgatorio/man/2/sys-remove

View raw version
.TH SYS-REMOVE 2
.SH NAME
remove \- remove a file
.SH SYNOPSIS
.EX
include "sys.m";
sys := load Sys Sys->PATH;

remove:	fn(file: string): int;
.EE
.SH DESCRIPTION
.B Remove
removes
.I file
from the directory containing it and discards the contents of the file.
The user must have write permission in the containing directory.
If
.I file
is a directory, it must be empty.
.B Remove
returns zero if it deletes the file, \-1 otherwise.
.SH SEE ALSO
.IR sys-intro (2)