TIP 91: Backward Compatibility for Channel Types with 32-bit SeekProcs

Login
State:		Final
Type:		Project
Tcl-Version:	8.4
Vote:		Done
Post-History:	
Author:		Donal K. Fellows <[email protected]>
Created:	03-May-2002

Abstract

[72] broke backward-compatibility for channels that supported the [seek] command, and this TIP adds the ability for old-style channels to work with the underlying 64-bit architecture.

Rationale

Although the ability to work with large files (as added by [72]) is crucially useful in many situations, it has introduced a few problems, one of which being that it broke backward compatibility for channel types (see http://sourceforge.net/tracker/?func=detail&atid=410295&aid=551677&group\_id=34191 for details.) Following discussion with the people concerned, I believe it is possible to modify the channel type structure so that old-style channels - i.e. those compiled against Tcl 8.3 - can still be supported (though with a limited range of operation.)

Proposed Change

The Tcl_ChannelType structure will have an extra field appended of type Tcl_DriverWideSeekProc called wideSeekProc, which shall be guaranteed to be present (though possibly NULL) whenever the version of the Tcl_ChannelType structure is at least TCL_CHANNEL_VERSION_3. The type Tcl_DriverSeekProc shall be reverted to its pre-[72] version, with the current type of Tcl_DriverSeekProc being transferred to the type Tcl_DriverWideSeekProc. In order to facilitate stacked channels, an additional requirement shall be imposed that if a channel driver implements a wideSeekProc, then it shall also implement a seekProc, so allowing stacked channels to work entirely in one domain or the other (well, in simple cases at least.)

Semantically, the core will handle seeks by preferring to use a wideSeekProc if present, and using the seekProc otherwise. Considering just the case where the seekProc is used, if the offset argument exceeds that which is representable in a long, Tcl_Seek will fail, simulating a system error of EOVERFLOW.

The only Tcl core channel which will need modification is the file channel; this will be adapted to generate an error of EOVERFLOW when the resulting offset in a file would otherwise exceed that which can be expressed in a long (which has the downside of making the seek operation no longer atomic when using the old interface, since the file offset will need to be restored to its old position in such cases.) On 64-bit platforms, both seekProc and wideSeekProc will be the same function.

Rejected Alternatives

I considered overloading the seekProc field to have different types depending on the value of the version field, but that's remarkably ugly and forces people to adapt rapidly at a source level. I don't know about everyone else, but I don't use a lot of programs at the moment that actually need access to files larger than 2GB.

I also considered allowing code to only implement the wideSeekProc but it was easier to code the way I ended up doing it and I don't think there are that many people writing channel drivers that support seeking anway.

Copyright

This document has been placed in the public domain.