blob: 118692d46a4a710b2a1ec1ef372581725f312b70 [file] [log] [blame]
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -06001 Y2K compliance in libpng:
2 =========================
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -06003
Glenn Randers-Pehrson94d93622004-11-01 22:38:54 -06004 November 2, 2004
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -06005
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -06006 Since the PNG Development group is an ad-hoc body, we can't make
7 an official declaration.
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -06008
Glenn Randers-Pehrson4393a9a1999-09-17 12:27:26 -05009 This is your unofficial assurance that libpng from version 0.71 and
Glenn Randers-Pehrson94d93622004-11-01 22:38:54 -060010 upward through 1.2.8beta2 are Y2K compliant. It is my belief that earlier
Glenn Randers-Pehrson4393a9a1999-09-17 12:27:26 -050011 versions were also Y2K compliant.
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -060012
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -060013 Libpng only has three year fields. One is a 2-byte unsigned integer
14 that will hold years up to 65535. The other two hold the date in text
15 format, and will hold years up to 9999.
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -060016
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -060017 The integer is
18 "png_uint_16 year" in png_time_struct.
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -060019
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -060020 The strings are
21 "png_charp time_buffer" in png_struct and
22 "near_time_buffer", which is a local character string in png.c.
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -060023
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -060024 There are seven time-related functions:
25
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -060026 png_convert_to_rfc_1123() in png.c
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -060027 (formerly png_convert_to_rfc_1152() in error)
28 png_convert_from_struct_tm() in pngwrite.c, called in pngwrite.c
29 png_convert_from_time_t() in pngwrite.c
30 png_get_tIME() in pngget.c
31 png_handle_tIME() in pngrutil.c, called in pngread.c
32 png_set_tIME() in pngset.c
33 png_write_tIME() in pngwutil.c, called in pngwrite.c
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -060034
35 All appear to handle dates properly in a Y2K environment. The
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -060036 png_convert_from_time_t() function calls gmtime() to convert from system
37 clock time, which returns (year - 1900), which we properly convert to
38 the full 4-digit year. There is a possibility that applications using
39 libpng are not passing 4-digit years into the png_convert_to_rfc_1123()
Glenn Randers-Pehrson4393a9a1999-09-17 12:27:26 -050040 function, or that they are incorrectly passing only a 2-digit year
41 instead of "year - 1900" into the png_convert_from_struct_tm() function,
42 but this is not under our control. The libpng documentation has always
43 stated that it works with 4-digit years, and the APIs have been
44 documented as such.
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -060045
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -060046 The tIME chunk itself is also Y2K compliant. It uses a 2-byte unsigned
47 integer to hold the year, and can hold years as large as 65535.
Glenn Randers-Pehrson4393a9a1999-09-17 12:27:26 -050048
49 zlib, upon which libpng depends, is also Y2K compliant. It contains
50 no date-related code.
Glenn Randers-Pehrson61c32d92000-02-04 23:40:16 -060051
52
Glenn Randers-Pehrson87544ac1999-01-13 22:06:39 -060053 Glenn Randers-Pehrson
54 libpng maintainer
55 PNG Development Group