Xinu7/man/man2/remove.2

.TH REMOVE 2
.SH NAME
remove \- remove a file from the file system
.SH SYNOPSIS
.nf
.B int remove(filename, key)
.B char *filename;
.B int key;
.fi
.SH DESCRIPTION
.I Remove
takes a file name as an argument and destroys the named file (i.e.,
removes it from the file system).
Argument \f2filename\f1 specifies the name of a file to remove, and
the optional argument \f2key\f1 gives a one-word protection key.
.PP
\f2Remove\f1 uses the namespace to map the given file name to a new
name, and invokes CONTROL(2) on the underlying device to destroy the file.
It returns SYSERR if the name is illegal or cannot be mapped to
an underlying device.
It returns whatever CONTROL(2) returns otherwise.
.SH SEE ALSO
control(2), nammap(2), namespace(4)