The Bottom Layer Functions

• fli-ios-bot-rea: The Bottom Layer Read Function
• fli-ios-bot-wri: The Bottom Layer Write Function
• fli-ios-bot-flu: The Bottom Layer Flush Function
• fli-ios-bot-see: The Bottom Layer Seek Function
• fli-ios-bot-clo: The Bottom Layer Close Function

There are five bottom layer functions for a stream: read, write, flush, seek and close. However, not all of these functions are needed for every stream:

• The seek function is not required when the seek_type is QP_SEEK_ERROR.
• The read function is only required for an input stream.
• The write function is only required for an output stream.
• The flush function is not required when the flush_type is QP_FLUSH_ERROR.
• The close function should be supplied for every stream.

These functions usually only operate on the specific fields of a particular user-defined stream. (i.e. Fields other than the first field in a user-defined stream structure.) The errno field and magic field in QP_stream part may also be maintained by the bottom layer functions. The mode field and max_reclen field are also typically accessed by the bottom layer functions.

Except for the read function, all the bottom layer functions return QP_SUCCESS upon success, and return QP_ERROR and assign an error code to the errno field upon failure. These functions are described further in subsequent sub-sections.