shithub: purgatorio

ref: f8935b5778397074d41a48205e5c7f87d7b531fe
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)