Detailed Description

Outline

Purpose
Classes
Description
- The Transitional-Compilation Environment

Purpose

Provide testable bdls::FilesystemUtil operations for some Unixes.

Classes

bdls::FileystemUtil_TransitionalUnixImpUtil: testable file-system utilities

See also: bdls_filesystemutil, bdls_filesystemutil_unixplatform

Description

This subordinate component to bdls_filesystemutil provides a utlity struct template, bdls::FilesystemUtil_TransitionalUnixImpUtil for implementing some of bdls::FileystemUtils functions on Unix platforms in the transitional-compilation environemnt. bdls::FilesystemUtil_TransitionalUnixImpUtil accesses Unix functions and types through its template parameter, UNIX_INTERFACE, in order to allow tests to supply mock Unix interfaces.

The Transitional-Compilation Environment

Many Unix systems provide a non-standard "transitional-compilation environment", which is a compilation mode that supports large, 64-bit file operations in 32-bit (or 64-bit) programs. For more information about this and other large-file compilation modes, please see the lfcompile64 and/or lfcompile manual pages provided for the operating system of interest. Note that some Unix systems may not support a transitional-compilation environment, and some that do may provide descriptions of this environment in documentation outside of a lfcompile64 or lfcompile manual page. Furthermore, some Unix systems natively provide 64-bit file operations for 32-bit programs, in which case a transitional-compilation environment is not necessary.

Another subordinate component of bdls_filesystemutil , bdls_filesystemutil_unixplatform, is principally concerned with the detection of the transitional-compilation environment on any Unix platform supported by the BDE library.