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