Xinu7/man/man2/remove.doc

REMOVE(2)           Xinu Programmer's Manual            REMOVE(2)



NAME
     remove - remove a file from the file system

SYNOPSIS
     int remove(filename, key)
     char *filename;
     int key;

DESCRIPTION
     _R_e_m_o_v_e takes a file name as an argument and destroys the
     named file (i.e., removes it from the file system).  Argu-
     ment _f_i_l_e_n_a_m_e specifies the name of a file to remove, and
     the optional argument _k_e_y gives a one-word protection key.

     _R_e_m_o_v_e 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.

SEE ALSO
     control(2), nammap(2), namespace(4)

































Version 6b               Printed 1/12/87                        1