Introduction

In the past, many operating systems imposed a limit which defined how large a single file could become. This limit was 2 Gb on some systems, and 4 Gb on others. For example, on HP-UX 10.20 or 11.00 Unix systems, the maximum file size is 2 Gb unless the file system has the largefiles option turned on. This limit still exists on some operating systems.

gsplit is a filter utility introduced with Interbase 5.0 which allows the output file from the gbak utility (when backing up a database) to be split into a number of chunks, or a number of chunks to be joined together and used to restore a database. Up until Interbase 5.0, dump files were limited to 2 Gb by the gbak utility itself - even if running on a system which allowed files to be 4 Gb.

Coming up in the remainder of this manual, we will discuss the following:

• Command-line options for gsplit.
• gsplit options and their parameters.
• Splitting backups using gsplit.
• Joining backup chunks using gsplit.

Note: From Interbase 6.0, gsplit is no longer required as gbak allows large files to be split directly. The details for gsplit given here are for reference only and you are advised to use gbak to split large backup files even if gsplit is supplied with your Firebird release.

gsplit is only supplied with the Windows version of Firebird 1.5, it is not supplied with the Linux version. Linux doesn't require a separate utility as it can split files using the split command as well as using gbak.

Warning: In testing with Firebird 1.5 and Firebird 2.0 on Windows XP Home and WIndows 2000, gsplit doesn't seem to work properly and always returns an error.

Because of the problems in getting gsplit to work correctly, as you shall see in the remainder of this manual, you are advised to use the splitting and joining facilities of the gbak utility itself rather than trying to make gsplit work for you.