.RFILE - release a permanent file.
Alternate Entry Name: _RFILE
Usage:
B:
stat = .rfile(file [, opts]);
C:
int _rfile(const char *file [, const char *opts]);
Examples:
.rfile("user/cat/file");
.rfile("/file", "p");
Where:
- file
- is a string with the name of the file to release.
- opts
- is a string specifying options. The options are specified
by letters from the following list:
- f
- FMS recovery. If an error occurs, .RF will return
to the caller with a status, instead of
terminating with an error message.
- m
- Message. This prints the FMS error message, even
though the "f" option was specified.
- p
- Purge. This writes zeroes over the file space
before releasing it to the system.
- stat
- is the negative of the FMS status. Non-zero values will
only be returned if the "f" option was
specified.
Description:
.RFILE provides a simple way to release a permanent file from
the system. Error messages are posted through the standard .EPOST
facilities; see "expl b lib
.epost" for details.
See Also:
expl b lib .ccfil
expl b lib external flsyer
Copyright © 1996, Thinkage Ltd.