FS CLOSE: Difference between revisions
Created page with "Closes the specified file handle. ==Syntax== FS_CLOSE(type, IOflag, psffsi, psffsd) ==Parameters== ;type :Indicates what type of a close operation this is. :type == ..." |
m har |
||
| Line 1: | Line 1: | ||
Closes the specified file handle. | {{DISPLAYTITLE:FS_CLOSE}} | ||
Closes the specified file handle. | |||
==Syntax== | ==Syntax== | ||
FS_CLOSE(type, IOflag, psffsi, psffsd) | FS_CLOSE(type, IOflag, psffsi, psffsd) | ||
==Parameters== | ==Parameters== | ||
;type | ;type:Indicates what type of a close operation this is. | ||
:Indicates what type of a close operation this is. | :type == 0 indicates that this is not the final close of the file or device. | ||
:type == 1 indicates that this is the final close of this file or device for this process. | |||
:type == 0 indicates that this is not the final close of the file or device . | :type == 2 indicates that this is the final close for this file or device for the system. | ||
:type == 1 indicates that this is the final close of this file or device for this process. | ;IOflag:Indicates information about the operation on the handle. | ||
:type == 2 indicates that this is the final close for this file or device for the system. | :IOflag == 0x0010 indicates write-through. | ||
:IOflag == 0x0020 indicates no-cache. | |||
;IOflag | ;psffsi:Is a pointer to the file-system-independent portion of an open file instance. | ||
:Indicates information about the operation on the handle. | ;psffsd:Is a pointer to the file-system-dependent portion of an open file instance. | ||
:IOflag == 0x0010 indicates write-through. | |||
:IOflag == 0x0020 indicates no-cache. | |||
;psffsi | |||
:Is a pointer to the file-system- | |||
==Calling Sequence== | |||
== | |||
<PRE> | <PRE> | ||
int far pascal FS_CLOSE(type, IOflag, psffsi, psffsd) | int far pascal FS_CLOSE(type, IOflag, psffsi, psffsd) | ||
| Line 33: | Line 25: | ||
struct sffsd far * psffsd; | struct sffsd far * psffsd; | ||
</PRE> | </PRE> | ||
==Remarks== | ==Remarks== | ||
This entry point is called on the every close of a file or device. | This entry point is called on the every close of a file or device. | ||
Any reserved resources for this instance of the open file may be released It may be assumed that all open files will be closed at process termination. That is, this entry point will always be called at process termination for any files or devices open for the process. | Any reserved resources for this instance of the open file may be released It may be assumed that all open files will be closed at process termination. That is, this entry point will always be called at process termination for any files or devices open for the process. | ||
A close operation should be interpreted by the FSD as meaning that the file should be committed to disk as appropriate. | A close operation should be interpreted by the FSD as meaning that the file should be committed to disk as appropriate. | ||
Of the information passed in IOflag, the write-through bit is a mandatory bit in that any data written to the block device must be put out on the medium before the device driver returns. The no-cache bit, on the other hand, is an advisory bit that says whether the data being transferred is worth caching or not. | Of the information passed in IOflag, the write-through bit is a mandatory bit in that any data written to the block device must be put out on the medium before the device driver returns. The no-cache bit, on the other hand, is an advisory bit that says whether the data being transferred is worth caching or not. | ||
[[Category:IFS Interfaces]] | [[Category:IFS Interfaces]] | ||
Latest revision as of 01:32, 9 February 2020
Closes the specified file handle.
Syntax
FS_CLOSE(type, IOflag, psffsi, psffsd)
Parameters
- type
- Indicates what type of a close operation this is.
- type == 0 indicates that this is not the final close of the file or device.
- type == 1 indicates that this is the final close of this file or device for this process.
- type == 2 indicates that this is the final close for this file or device for the system.
- IOflag
- Indicates information about the operation on the handle.
- IOflag == 0x0010 indicates write-through.
- IOflag == 0x0020 indicates no-cache.
- psffsi
- Is a pointer to the file-system-independent portion of an open file instance.
- psffsd
- Is a pointer to the file-system-dependent portion of an open file instance.
Calling Sequence
int far pascal FS_CLOSE(type, IOflag, psffsi, psffsd) unsigned short type; unsigned short IOflag; struct sffsi far * psffsi; struct sffsd far * psffsd;
Remarks
This entry point is called on the every close of a file or device.
Any reserved resources for this instance of the open file may be released It may be assumed that all open files will be closed at process termination. That is, this entry point will always be called at process termination for any files or devices open for the process.
A close operation should be interpreted by the FSD as meaning that the file should be committed to disk as appropriate.
Of the information passed in IOflag, the write-through bit is a mandatory bit in that any data written to the block device must be put out on the medium before the device driver returns. The no-cache bit, on the other hand, is an advisory bit that says whether the data being transferred is worth caching or not.