add changelog
[platform/upstream/gdbm.git] / NOTE-WARNING
1 ******************************************************************************
2                                  W A R N I N G
3 ******************************************************************************
4
5 Gdbm files have never been `portable' between different operating systems,
6 system architectures, or potentially even different compilers.  Differences
7 in byte order, the size of file offsets, and even structure packing make
8 gdbm files non-portable.
9
10 Gdbm version 1.9 includes `large file' support, enabling it on operating
11 systems where it is not the default.  `Large file' support is essentially
12 when a system uses 64bit file offsets.  Gdbm has, of course, supported `large
13 files' on systems where it was the default for a very long time.
14
15 On some systems, such as Solaris, this functionality is not enabled by
16 default.  Gdbm will now enable it.  THIS MEANS THAT GDBM 1.9 MAY NOT BE
17 ABLE TO ACCESS DATABASES CREATED BY PREVIOUS VERIONS ON THE SAME SYSTEM.
18
19 Running the `configure' script with the `--disable-largefile' flag should
20 produce a backwards-compatible build on such a system.  However, for maximum
21 compatibility, and increased functionality, you may want to have your
22 application produce a portable copy of your database with the 1.8.3 version
23 of the library, and then load it back into version 1.9.
24
25 Gdbm 1.9 contains a utility designed to help you produce such a portable
26 copy: gdbmexport.  To build it, configure the package with the
27 --enable-gdbm-export option.  For the information on how to use this
28 utility, refer to the documentation, chapter 17 "Export a database into
29 a portable format." (run `info gdbm gdbmexport' to access it, once
30 gdbm 1.9 has been installed, or `info -f doc/gdbm.info gdbmexport' to
31 access the shipped info file).
32
33
34