en:ibm:ifs:routines

FS Service Routines

The following table summarizes the entry points that make up the interface between the kernel and the FSD.

Note: Names must be in all upper case, as required by OS/2 naming conventions.

# FS Entry Point Description FSDs Required
to export
1. FS_ALLOCATEPAGESPACE Adjust the size of paging file PAGE I/O
2. FS_ATTACH Attach to an FSD ALL
3. FS_CANCELLOCKREQUEST Cancel file record lock request FILE I/O
4. FS_CHDIR Change/Verify directory path ALL
5. FS_CHGFILEPTR Move a file's position pointer ALL
6. FS_CLOSE Release a file handle ALL
7. FS_COMMIT Flush a file's buffer to disk ALL
8. FS_COPY Copy a file ALL
9. FS_DELETE Delete a file ALL
10. FS_DOPAGEIO Perform paging I/O operations PAGE I/O
11. FS_EXIT End of a process cleanup ALL
12. FS_FILEATTRIBUTE Query/Set file's attributes ALL
13. FS_FILEINFO Query/Set file's information ALL
14. FS_FILEIO Multi-function file I/O ALL
15. FS_FILELOCKS Request a file record lock/unlock FILE I/O
16. FS_FINDCLOSE Directory search close ALL
17. FS_FINDFIRST Find first matching filename ALL
18. FS_FINDFROMNAME Find matching filename from name ALL
19. FS_FINDNEXT Find next matching filename ALL
20. FS_FINDNOTIFYCLOSE Close FindNotify handle ALL
21. FS_FINDNOTIFYFIRST Monitor a directory for changes ALL
22. FS_FINDNOTIFYNEXT Resume reporting directory changes ALL
23. FS_FLUSHBUF Commit file buffers to disk ALL
24. FS_FSCTL File system control ALL
25. FS_FSINFO Query/Set file system information ALL
26. FS_INIT FSD initialization ALL
27. FS_IOCTL I/O device control ALL
28. FS_MKDIR Make a directory ALL
29. FS_MOUNT Mount/unmount volumes ALL
30. FS_MOVE Move a file or subdirectory ALL
31. FS_NEWSIZE Change a file's logical size ALL
32. FS_NMPIPE Do a named pipe operation ALL
33. FS_OPENCREATE Open/create/replace files ALL
34. FS_OPENPAGEFILE Create paging file and handle PAGE I/O
35. FS_PATHINFO Query/Set a file's information ALL
36. FS_PROCESSNAME FSD unique name canonicalization ALL
37. FS_READ Read data from a file ALL
38. FS_RMDIR Remove a subdirectory ALL
39. FS_SETSWAP Notification of swapfile ownership ALL
40. FS_SHUTDOWN Shutdown file system ALL
41. FS_VERIFYUNCNAME Verify UNC server ownership UNC
42. FS_WRITE Write data to a file ALL

Each FS entry point has a distinct parameter list composed of those parameters needed by that particular entry. Parameters include:

  • File pathname
  • Current disk/directory information
  • Open file information
  • Application data buffers
  • Descriptions of file extended attributes
  • Other parameters specific to an individual call

Most of the FS entry points have a level parameter for specifying the level of information they are provided or have to supply. FSDs must provide for additional levels which may be added in future versions of OS/2 by returning ERROR_NOT_SUPPORTED for any level they do not recognize.

File system drivers which support hierarchical directory structures must use '\' and '/' as path name component separators. File system drivers which do not support hierarchical directory structures must reject as illegal any use of '\' or '/' in path names. The file names '.' and '..' are reserved for use in hierarchical directory structures for the current directory and the parent of the current directory, respectively.

Unless otherwise specified in the descriptions below, data buffers may be accessed without concern for the accessibility of the data. OS/2 will either check buffers for accessibility and lock them, or transfer them into locally accessible data areas.

Simple parameters will be verified by the IFS router before the FS service routine is called.

Note: New with 2.0, some entry points need only be exported and supported by those FSDs which desire to service the pager (PAGE I/0), UNC servers (UNC) and/or file locking (FILE I/O). With these new entry point groups, a FSD must export all or none of the entry points within a particular group.

These optional entry points are:
FS_ALLOCATEPAGESPACE (PAGE I/O)
FS_CANCELLOCKREQUEST (FILE I/O)
FS_DOPAGEIO (PAGE I/O)
FS_FILELOCKS (FILE I/O)
FS_OPENPAGEFILE (PAGE I/O)
FS_VERIFYUNCNAME (UNC)