Changes since Pike 7.8.700 (fourth 7.8 release):
----------------------------------------------------------------------
o Core:
- Improve robustness against outputting wide strings.
master()->handle_error() now survives if, for example, an object has
an _sprintf() that returns a wide string.
master()->compile_{error,warning}() now survive messages about
wide symbols.
Made a similar fix in Hilfe to survive compiler warnings and
errors about wide symbols.
Fixes [bug 6805].
- Avoid recursion on the C-stack, to avoid running out of C-stack when counting
huge argument lists.
Fixes [bug 6860].
- do not use alloca in sprintf()
This fixes a stack corruption bug which occurs when using certain compilers
(e.g. msvc).
- Pike.gc_parameters(): Added some gc callbacks.
Adds callbacks that are called from the gc to simplify
debugging of memory leaks and similar.
- Improvements in searches on wide strings.
- Fixed padding bug in string_builder_append_integer().
The support for left padding was broken, and would always
add the full padding string and also would add erroneous left padding
if the field was full.
This bug also affected sprintf().
- Fixed Coverity Scan IDs [SCAN 742690] [SCAN 742691] [SCAN 742477]
o Debug:
- activate __CHECKER__ and CLEANUP when --with-valgrind
- Get rid of some harmless valgrind warnings
o Build:
- Fixed --enable-dlmalloc on systems with struct mallinfo.
- Improved support for building with clang.
- New RPM definition for Pike 7.8 originally based on spec from repoforge.
- Build improvements on Windows/sprshd (avoiding I/O redirection).
- Enable the full address space on NT.
The default address space on NT is just 31 bits. Attempt to
get the linker to enable the full addressspace.
- Don't execute $CFLAGS as a command
- Add -mcpu=niagara to CFLAGS on sun4v
- Disable machine code when compiling using GCC 4.6.0 and above, to avoid
a broken machine code generator.
- Adopted Gz configure checks to work with/accept zlib 1.2.12 changed
behaviour.
o Threads:
- Fixed hang in co_wait_interpreter().
co_wait_interpreter() would hang (waiting for threads to be
reenabled) if called in a disabled_thread context. This happens
on OSes using USE_WAIT_THREAD (eg Solaris) if a process is waited
on in a disabled_thread context.
o Backend:
- Improved thread safety in find_call_out() et al.
backend_find_call_out() called is_eq() (which may call Pike code
and release the interpreter lock) in a PROTECT_CALL_OUTS() context.
This could cause call_out operations performed in other threads to
either (no debug) mess with the hash table being traversed or (with
debug) cause the fatal "Recursive call in call_out module.".
- Fixed typo in out of band data handling.
Fixes [LysLysKOM 20481103]/[Pike mailing list 13683].
o Bug-fixes and New Methods in Modules:
ADT:
- Fix initialization bug in CircularList.allocate().
Fixes LysLysKOM 20179471/Pike mailinglist 13520.
- Working int32/SWord in Struct.
Calendar:
- Improve reentrancy of Timezone.compile().
The runtime timezone compiler was not thread safe, and could
fail with the compiler error "Undefined identifier forever."
when multiple concurrent threads compiled the same timezone.
Potentially fixes [bug 6816] #1:1.
- Fixed bug where the month was lost with %a to Calendar.parse.
Crypto:
- RSA: generate_key() now ensures that the key has the correct size.
Fixes [bug 6620].
- Added module Crypto.Password, for easy handling of password hashes.
- MD5: Added crypt_hash().
- SHA: Added the crypt_hash() function from SHA-crypt.
This implements the hashing function used in modern POSIX
operating systems. Implemented from the reference document
http://www.akkadia.org/drepper/SHA-crypt.txt
Database:
- Enable Oracle 11
- Improved compatibility with newer versions of FreeTDS ODBC driver. Fetch
date types as fixed length as a workaround for bugs in FreeTDS.
- Support the MariaDB client library.
The MariaDB client library is a forward port of the LGPL
mysql client library from MySQL 3.23 to support modern
MySQL and MariaDB.
- Potential workaround for race-condition in Mysql.create().
It seems mysql_real_connect() and/or mysql_close() aren't
fully thread-safe. The bug has been observed as recently as in
MySQL 5.5.30.
Errors: Improved emulation or arrays in object errors.
Implement _sizeof(), _indices() and _values() in the generic error class.
Fixes "Index 2 is out of range 0..1." from describe_backtrace().
GTK2:
- Add connect_before option to signal_connect so you can connect the signal
before or after the default hooks.
- Fixed infinite loop in encode_truecolor_24_rgb_al32().
- Fixed various issues in get_doc() et al.
- Change gobject signal connect to before instead of after.
- Fix a refcounting crash in GDKEvent.
- Pass arguments to accel_group callbacks separately rather than as
one array.
- Call the correct callback when an accelerator is hit.
- TreePath: Query the depth for get_indices() rather than looking for
a terminator.
- Add a signal_stop() method to prevent signal propagation.
Image:
- Fonts: Add PS_NAME attribute in info mapping if possible.
Needed to facilitate compatibility with code relying on behaviour of
older versions of FreeType.
- Fonts: Enhanced compatibility with newer versions of FreeType.
- JPEG: Disable the module if empty
- Add basic CMYK/YCCK support to Image.JPEG.decode(). Fixes [bug 6163].
- ColorTable: Fixed some memory leaks in add().
- XPM: Fixed memory zapping bug in _xpm_write_rows().
- Handle orientation information contained in JPEG EXIF information.
Since the default processing of JPEG in Image.JPEG was changed to
take EXIF Orientation into account, let's update Image.Dims to also
take that into account, so it correctly predicts the dimensions that
will result from loading the image.
Added Pike-level wrappers to Image.JPEG.decode() and Image.JPEG._decode()
in order to flips/rotates the decoded image based on EXIF Orientation
information, if such information is present. Also added an
Image.JPEG.raw_decode() to decode an image without rotating/flipping,
which works much like Image.JPEG._decode() did before overloading the EXIF
handling.
- Add support for native PSD files in Standards.IIM.
- Do not crash when decoding certain PNG files [TURBO2-80].
Java:
- Improve diagnostics on failure on NT.
- Attempt to support loading of Java 6 and 7 on NT.
-Use SetDllDirectory() to find required dlls. Fixes [bug 6471].
Oracle's jvm.dll has dependencies on runtime libraries that it doesn't
install in the global dll path or in the same directory. This patch
adds the directory where they do install the required dlls to the dll
search path, with a fallback to using the current directory on older NT.
The main change in this patch is to fix some calling-convention bugs in
earlier attempts, and to use the Unicode APIs.
Parser.XML:
- Tree: Fixed several issues in namespace handling.
- Tree: Fix some regressions. Fixes InfoKOM 731715.
- Tree: Improved namespace handling in default mode.
Process:
- Fixed multiple issues with search_path().
- Unified handling of $PATH.
* Added path_separator.
* search_path() now invalidates the cached path if $PATH is changed.
* search_path() now uses locate_binary() to scan the path.
* Moved an __NT__ special case from locate_binary() to search_path().
* spawn_pike() now uses search_path().
Protocols.DNS:
- Destruction of server now results in port closure.
- Support multiple strings per TXT record in the client, via new txta
mapping entry.
- Derived classes can now override report_decode_error() and
handle_decode_error() to change how errors while decoding a
DNS packet are reported and handled.
Protocols.HTTP:
- Don't modify the mapping sent to response_and_finish.
Unsuspecting users that pass a constant mapping to
response_and_finish when a particular error occurs (or when a
particular URL is requested) can fail if response_and_finish
alters the mapping. For example, future requestes may retain a
416 error if one request uses the Range: header.
- Support async keep-alive in Protocols.HTTP.Query. Fixes [bug 7143].
Protocols.SMTP: send_message() now punicodes the hostname.
Potential fix for [bug 6531].
Protocols.SNMP: Fixed error in GetRequest variable bindings.
The variable value should be ASN1 "Null" rather than a bogus integer.
C.f. RFC 1905 section #3.
Postgres.postgres_result:
Now properly decodes binary blobs and strips trailing spaces
from CHAR columns.
Sql.rsql:
- Implemented generic proxy of functions.
- Implemented support for all big_query() variants.
- This implements support for big_typed_query(), streaming_query()
and streaming_typed_query().
- Implement {get,set}_charset().
- Default to not reconnect on broken connection.
This behaviour is in line with the other SQL modules,
and is necessary to avoid corruption due to lost state.
- Implement ping() API.
ping() now signals if any part of the connection was reconnected (1),
or has been broken (-1).
- Fix reconnect code.
The state-machine on the client side when the rsqld server
died was broken in several ways. It now seems to work.
- Implemented insert_id().
SSL:
- Attempt to protect against some timing attacks.
Move around some code and attempt to get it to execute in constant time.
This is in an attempt to alleviate the "Lucky Thirteen" TLS attack.
- sslfile: Avoid rescheduling the ssl_read_callback on no read_callback.
This could lead to call_out loops taking 100% cpu, since no data would
be read from the read_buffer.
Potential fix for [bug 6582].
- sslfile: Added linger().
Implemented linger() API. The linger time is propagated to the raw
socket, and additionally a linger time of zero inhibits sending of
the close packet.
Stdio:
- cp() detects ouroboros and avoids infinite loops and file truncation.
- Reduce number of system calls in mkdirhier().
- Call fd_select() before fd_accept() in my_socketpair() to make sure it's ready.
Added support for poll() to the fd_accept() check in my_socketpair() and
lowered the select() timeout.
- Added linger(), to change the linger time on sockets.
- Fixed a bug in Stdio.FakeFile::read_function() where read data wasn't returned.
- Open files in binary mode, for systems that care (OS/2, etc).
Standards:
- Standards.EXIF supports rationals with a zero denominator.
The denominator may be zero to indicate infinites.
Fixes [bug 6729].
ZXID: Update the zxid_conf::path_len field.
Fixes [roxen.com #16333] where assertion data was lost after the redirect.
Web.CGI.Request: rest_query may be zero. Fixes [bug 6685].
Changes since Pike 7.8.352 (third 7.8 release):
----------------------------------------------------------------------
Extensions and New Functions
----------------------------
o Added module ZXID
This module provides an interface to the ZXID Identity Management
toolkit, which implements (among other tasks) the SAML 2.0, Liberty
ID-WSF 2.0, and XACML 2.0 protocols.
o Added module Search.
This module implements a free text search database. It needs some
indexed storage, and there is a storage backend for use with MySQL.
There is support for indexers with filters for different document
types. The query support includes metadata and date range searches.
It is the core of the search functionality that is used in the
commercial Roxen products, so it has been in production use for
quite some time already.
o Typed query result support in Sql.Sql and in the MySQL module.
Traditionally the SQL glue has returned all types of data as
formatted strings with their display representations. Now there are
new so-called "typed" variants of the query functions (typed_query,
big_typed_query, and streaming_typed_query in the Sql.Sql class)
that instead return the data as the appropriate pike native types,
e.g. pike integers for SQL integers, pike floats for SQL floats,
etc.
This requires support by the DB server specific backends, which is
currently limited to the MySQL glue.
o has_prefix now works on objects.
o Standards.JSON
New module for encoding and decoding JSON data. Implemented in C.
o Val
New module to contain some global special objects that are shared
between other modules. There is e.g. a Val.null object which is used
both by the Sql module to represent SQL NULLs in typed mode, and by
Standards.JSON to represent the null value.
o Protocols.HTTP.Session will no longer override an existing
content-type header in async_do_method_url.
o Protocols.HTTP
Allow directly specifying the body of a POST request (needed for the Google
Apps API).
A more complete list of response codes and descriptions is included and used.
Query includes proxy support for GET (http/https) and POST (https) in both
sync and async mode.
Query exposes close() so you do not have to wait for garbage collection.
Server adds Basic Range support.
o Regexp.PCRE.replace() adds support for capture groups.
o Updated timezone data to tzdata2010o.
o String.normalize_space
New and efficient C implementation; sanitises whitespace, even in wide
strings.
o String.trim_all_whites
Extended to the entire range of Unicode white spaces. (And is faster.)
o Tools.PV and pike -x pv now work with GTK2 as well as GTK.
o Integer constants exported by modules can now be used in cpp expressions.
o Modules/programs that have the constant "dont_dump_program" will not
be dumped on installation. This is used to prevent dumping of
programs that check for external dependencies at compile time such
as the MySQL module.
o Added Thread.Queue.peek_array.
o Fixed stack overrun bug in Nettle.CBC and Nettle.Proxy. This is not
believed to have been a security issue.
o System
Added getloadavg() on platforms that support the getloadavg() call.
Added cross-platform get_home() and get_user() wrappers.
Added GetUserName() for Windows systems.
o SSL
Added support for AES to SSL3, and fixed bug that prevented some
handshake failure alerts to be sent to the client.
Implemented RFC 5746 "TLS Renegotiation Indication Extension".
Support parsing of Hello Extensions (RFC 5246 7.4.1.4).
o Stdio
New methods in Stdio.File:
set_callbacks() and query_callbacks() for handling several callbacks at
once.
send_fd() and receive_fd() allow file descriptors to be sent and received
over UNIX-domain sockets.
The type for Stdio.Fd.create() is now as documented.
Stdio.Terminfo contains a new class, MetaTerminfoDB, that merges several
terminfo directories.
Stdio.File()->query_address() now knows about IPv6-mapped IPv4 addresses.
Added some extra magic to Stdio.File()->connect() when mixing IPv4 and IPv6
addresses.
o ADT.Heap->values and ->num_values can now be overloaded.
o Added support for binding a Protocols.DNS server to multiple port/interface
combinations.
o Support for asynchronous DNS query replies in Protocols.DNS.
o Calendar
dwim_time() should know how to parse ISO 8601 timestamps.
Added Calendar.Greek.
o Process
Process.spawn(), popen() and system() et al now use Process.Process.
Process.Process adds support for spawning processes via forkd.
Process.spawn_pike() can now optionally pass predefines as well as
program and include path arguments.
Process.spawn_pike() should also be more reliable on Windows.
o Added functions to access the numerator and the denominator of a Gmp.mpq.
o Added lower level functions Tools.X509.[dr]sa_sign_key(). This makes it
easier to create hierarchial certificates.
make_selfsigned_[dr]sa_certificate() now use the corresponding
[dr]sa_sign_key().
o Added SSL3.sslfile.{set,query}_callbacks() as per Stdio.File.
o Added the !-modifier for sscanf().
o Added Int.reflect().
o Image.Dims adds support for Photoshop files.
o Added Gmp.encode_json().
o Added Thread.Queue.peek_array.
o Add System.getloadavg() on platforms that support the getloadavg() call.
o Pike.Backend has reinstated call_out memory usage, and a new function,
Pike.DefaultBackend.get_stats() for viewing this data.
o Locale.Charset now supports encoding and decoding UTF32.
o Added Sql.Sql()->is_open() and Sql.Sql()->ping(). Note that
your chosen database module must support these (Mysql and pgsql
currently do).
o MIME.ext_to_type() now knows about most all popular mime types (including
~700 new entries).
Optimizations
-------------
o MIME should now use 1/3 less memory when decoding big messages.
o Nettle.hash
Avoid allowing threads during hashing of small strings (current threshold
is 1 MB). This change improves ApacheBench numbers ~20% for a Roxen
benchmark on a quad-core Core i5.
o String.trim_all_whites is 10% faster and includes all Unicode.
o Improved performance of Process.run when threads aren't supported.
o Locale.Charset improves performance of encoders when replacement is active
by a few magnitudes.
o pike -x pmar_install can install from an http/s url, supports gzipped
archives, md5 hash checking and better uninstall support on Windows.
o Monger
Monger (pike -x monger) can now install pmar (pre-built module archives)
from the module repository, when available (particularly useful on Windows).
Monger can also download and build from a module's source repository (svn,
hg, git) when specified in the Pike module repository (modules.gotpike.org).
Deprecations
------------
o The libpq based old Postgres driver is now deprecated. The new pgsql
driver is faster, better tested, more stable, maintained, has more
features, does not depend on external libraries and is less filling.
o Stdio.File: << is deprecated.
Incompatible changes
--------------------
o Signal handlers in GTK2 do no longer get their arguments in the
form of an array. The prototype for a signal handler which was
previously e.g.
int query_tooltip(GTK2.Widget w, array(mixed) params, mixed callback_arg)
now becomes
int query_tooltip(GTK2.Widget w, int x, int y, int keyboard_tooltip,
GTK2.GObject tooltip, mixed callback_arg)
Bug fixes
---------
o Architecture/OS specific:
- Fixed segfault in combine_path_nt on windows when the first char
of an appended path is wide.
- Stdio.cp should now work on directory trees on Windows.
- Fixed bug that caused file_stat on Windows NT to not return a result
on certain non-FAT filesystems. Fixes bug 6432.
- Fixed a root directory check in Stdio on Windows NT. Fixes bug 3759.
o Calendar module:
- Fixed backward compatibility for Calendar.iso_name() and
Calendar.iso_short_name().
- Fix evaluation order for Calendar.YMD.`+().
- Fixed problem with Calendar.month_from_yday() when applied on week
53. [bug 5303]
o Compiler:
- Fixed issue where a stale pointer into the identifier table could
sometimes be dereferenced when defining getters and setters.
- Fixed NULL-deref for compilation errors in range expressions.
- Fixed bug that prevented the literal zero from being considered a constant.
- Fixed fatal error in the constant expression evaluator of the
compiler for certain code.
o Documentation:
- Added Autodoc support for new-style getter and setter syntax.
- Fixed support for documenting arguments to implicit create().
o Graphics:
- Fixed leak in the PNG decoder for images with tRNS chunk.
- Fixed several issues related to lables on the X and Y axises
and the calculation of xmaxvalue for the bars/line/linear case
in Graphics.Graph.
- Fix integer underflow in Image.JPEG. Fixes [bug 6413].
o I/O:
- Support undocumented OS behaviour on out-of-band data returning
EOPNOTSUPP and ECONNRESET when a stream is half closed.
The undocumented behaviour is found on (at least) 2.6.x Linux
and FreeBSD 7.x and 8.x.
- Stdio.{write,append}_file() now throw errors in ALL failure modes.
- Stdio.File()->query_address() should return a correct errno when given
a socket with an invalid protocol family.
- Stdio.File()->file_peek() now refrains from releasing the interpreter
lock if there's no timeout.
o Protocol modules:
- Fixed backtraces when Protocols.HTTP.Query objects where garbage
collected. [bug 5730]
- Multiple multipart file submissions in Protocols.HTTP.Server will be
preserved as suggested by HTML5.
- Protocols.HTTP.Query fixes broken state when open_socket() has thrown
an error.
- Tools.Standalone.httpserver has fixed entity encoding. Makes files
with spaces in them accessible.
- Protocols.HTTP Sets the content-length header for zero-length data.
Fixes [bug 5936].
- Protocols.HTTP.Query uses content-length instead of content_length.
The latter will be corrected in the encode method, but is problematic
when that function is overridden.
- Protocols.HTTP.Query filters weak SSL-ciphers rather than explicitly
listing strong ones.
- Protocols.HTTP includes some close, state reset and keep-alive handling
fixes.
- Fixed so than an existing content-type is not overriden in
async_do_method_url.
o Runtime:
- Use nanosleep() when available instead of poll or select hacks for
the Pike-level sleep() function.
- Fixed a segfault occuring if exit() is used from a thread when
the Pike runtime has been compiled with cleanup-on-exit enabled.
- Fixed bug in new_check_call(). Fixes [bug 6442].
- Prevent short disablements of the gc from affecting gc intervals.
o sprintf:
- Fix a buffer overrun when formatting Gmp.mpz as floats if the precision
exceeds the number of digits.
- Ensure that decimal points are used when floats are formatted
in casts etc. Previously the float formatting in casts and in
sprintf("%O",...) were susceptible to locale settings and could
therefore use something other than a '.' as decimal separator.
Note that sprintf("%f",...) is still locale sensitive.
o Sql database modules:
- Fixed memory leak on out of memory in Mysql.fetch_json_result().
- Fixed locking problem in Mysql.
- Fixed dangling cache reference in prepared statements when using CREATE
statements via Sql.pgsql.
- Fixed broken (auto-re-) connect logic in Sql.pgsql.
- Support all text queries in Sql.pgsql.
- Fixed rare string corruption in Sql.pgsql.
o SSL/TLS:
- Fixed bugs in handling of abrupt SSL3 remote close. sslfile now also
triggers EPIPE errors if the user attempts to read or write to a
connection that has been abruptly closed (to detect truncation
attacks better).
- Fixed issue where SSL3 async_client objects became garbage even
after close().
- Tools.X509 uses a unique serial number for each selfsigned certificate.
Firefox otherwise complains about serial number clashes.
o Misc:
- System.normalize_path no long fails for files with 8-bit chars in
their names.
- Improved widestring support for Parser.Tabular.
- Fixed a problem in "pike -x module" that prevented auto tools from
running in the correct directory.
- Fixed issue where GTK objects weren't destroyed properly.
http://pike.ida.liu.se/docs/tutorial/hello/window.xml now
works again.
- Fixed encoding/decoding bug in "pike -x httpserver" that prevented
files with space in the name from being accessable.
- Parser.XML.Tree contains fixes for add_child_before() and add_child_after().
- Parser.Tabular fixes support for Stdio.File objects. For example:
Pike v7.8 release 468 running Hilfe v3.5 (Incremental Pike Frontend)
> Parser.Tabular(Stdio.File("data.csv"), Stdio.File("format.csv"));
- Fixed return value from Regexp.PCRE.exec to always have entries for all
submatches.
- Fuse has fixed support for readlink().
- Fixed infinite loop in Audio.Format when reading MP3 frames.
- Added path to pike binary in pike -x module used by verify targets.
Should also fix problems installing modules using pike -x monger.
- Reduce optimization in gethostby{addr,name} that could cause
overzealous caching or results.
Building, installing and developer tools
----------------------------------------
o Fixes to allow Regexp.PCRE to compile against recent versions of PCRE lib.
o Fix Gz module build on recent Gentoo Linux.
o Fixed some library searchpath issues.
o Some potential fixes for --enable-pikelib mode on platforms had
problems with the final linking.
o Some issues with the support for building modules needing
a C++ compiler have been fixed.
o Made it possible to override $(OS) with an environment variable
$PIKE_BUILD_OS.
o Check for configure scripts built with pre-propagated_variables pike.
o Added Nettle/config.guess that knows about MaxOS X and x86_64.
o Fix broken detection of libjpeg lossless transformation support.
o Installer will no longer dump sql driver files that depend on
system libraries.
o Fixed support for --without-threads.
o Fix to make dump.pike dump itself just like any other module class.
o Improved support for LIBPIKE.
o Added PIKE_CORE define to detect when not compiling a module.
o Improved support for autoconf 2.6x.
o Ensure that --with-rtldebug enables assertions.
o Configure script now attempts to set up the PKG_CONFIG_PATH.
o Updated the ABI selector for MacOS X. Default to attempting the compiler
default ABI (instead of forcing 32-bit ABI).
o CMOD Enhancements
Tools.Standalone.precompile supports ranges for strings and negative
int(low..high) bounds.
Fixed bug in generate_overload_func_for() when there are alternatives
accepting zero arguments.
o Tools.Testsuite:
Added some functions to make pretty logging in tests easier.
Tools.Standalone.test_pike passes the verbosity level in an environment
variable TEST_VERBOSITY to subtests.
Tools.Testsuite accumulates multiple result reports.
Changes since Pike 7.8.316 (second 7.8 release):
----------------------------------------------------------------------
General
-------
o ADT.Heap
The compat functions top() and size() are now marked as deprecated.
Extensions and New Functions
----------------------------
o Image.Image
Added support for sending Color objects to the color() function.
o Sql.Sql
Added support for fetching result sets as JSON-encoded strings.
o Calendar
Updated timezone data to 2009j.
o Parser.XML.Tree
Output from render_xml() is now on canonical form.
o Added "pike -x httpserver" that implements a minimal HTTP-server
exporting the current directory.
Optimizations
-------------
o Lowered startup time by extending encode_value() and MasterCodec so
that master.pike can be precompiled.
o Lowered startup time by reducing the number of MEMSET() calls done
on startup.
o Allow threads while calling SDL_GL_SwapBuffers.
o Added optimization of has_value() and search() for single-character strings.
o Added optimization when combining two arrays where the second array
contains a single item.
Bug fixes
---------
o Fixed casting of floats to strings to again work more like in Pike
7.6 and earlier: The string will always contain either a "." or an
"e" to signify that it is a float, and it will no longer display so
many digits that the binary/decimal conversion errors become
visible.
o Protocols.HTTP.Server.HeaderParser will now discard parts of a
header value if the header value contains a newline (like "Host:
google.com\n.hax.net\r\n") and headers without colon.
o file_open_socket() now attempts to set SO_REUSEPORT on the socket.
Potentially fixes issues on FreeBSD 7.x where ports aren't reused.
o Calendar.TimeRanges now knows that `+() and `-() can get any number
of arguments.
o The experimental extended ZFS support is disabled since it pulled in
unwanted dependencies.
o Fixed propagation of changed module directories for joinnodes by
zapping the joinnode cache.
o Fixed memory leak in Image.WBF.
o Fixed potential NULL-deref in Image.XWD.
o Fixed potential NULL-deref in Image.PNG.
Building and installing
-----------------------
o Nettle 2.0 is now supported.
Changes since Pike 7.8.116 (initial 7.8 release):
----------------------------------------------------------------------
General
-------
o Sql.pgsql:
- Substantial documentation improvements.
o Stdio.Fd_ref is deprecated and in the process of being eliminated.
You have never used it before, so don't start using it now.
Bugfixes
--------
o Fixed bug in AGGR_ARR_EPILOGUE() (aka END_AGGREGATE_ARRAY()) that
caused the empty array to always be returned if there were no
unaggregated elements on the stack at END_AGGREGATE_ARRAY.
You are encouraged to upgrade just for this fix since the bug
creates very rare but (seemingly) random occurances of empty arrays.
o Fixed multiset_delete_node to work with destructed indices. This
fixes occasional bugs in various functions when there are destructed
objects in indices.
You are encouraged to upgrade just for this fix since the bug creates
(seemingly) random crashes that are hard to reproduce and track down.
o Fixed overzealous filtering of the value returned from Stdio.File()->mode().
This bug caused Stdio.nb_sendfile to always run in blocking mode.
You are encouraged to upgrade just for this fix since the bug can
cause supposedly nonblocking actions to block and hang the script.
o Fixed bug in the Odbc module on WIN32 where it would fail for some
field-types with the error "22003:Numeric value out of range".
o Sql.pgsql:
- Various small fixes and performance improvements.
- Fixed fully transparent UTF8/Unicode/wide string/character set support.
- Fixed formatting errors in error().
o Fixed bug when seeking backwards in Gz.File.
o Fixed bug in fd_stat on windows when used on a file system with a
long name.
o Fixed off-by-one bug in Stdio.Readline that caused a space in the
last column to disappear instead of being converted to a linefeed
when word wrapping is used.
o Fix bug in FakeFile.read()
Replaced the broken-in-multiple-ways implementation by something that
actually works (hence the original enlightnening description: "fixed a bug",
there is really no concise way to classify this level of brokenness).
o Image.TIFF: Fixed memory leak on OOM.
o Fixed crash bug in yyexplain_not_implements().
o LysKOM.ProtocolTypes: Bugfix of LocalToGlobalBlock
o Protected Pike_fatal() against the risk of hanging on mutexes.
o Added 7.6 compat versions for RegGet{Value{,s},KeyNames}().
o Fixed memory leak in Image.Colortable.
o Parser.SGML: Reinstated the class as Parser.SGML(). It inadvertedly
became Parser.SGML()->SGML() in the move to a separate file.
Parser.SGML.SGML is kept as a compatibility alias.
o Added Pike 7.6 and earlier compat for store_constant(UNDEFINED).
o Fixed race-condition causing "Lost track of child" on pikes compiled
--without-threads.
o Regexp.PCRE: Do not match the empty string past the end of the input.
o Reduced the risk of throwing out-of-stack errors while formatting an
out-of-stack backtrace.
o Fixed bug that would cause sprintf's %nH to refuse all strings as too
long for some values of "n" on some architectures.
o Made Process.search_path() aware if Win32 and AmigaOS specifics.
o Fixed bug in Protocols.HTTP.Query that dropped the last byte of a
request if the server did not provide a Content-Length header.
o Fixed bug in Protocols.HTTP.Query that dropped the first argument to
the async_fetch() callbacks (ie the query object) in some circumstances.
o Fixed bug in Protocols.HTTP.AsyncClient that made all data decoding fail.
o Fixed fatal "Invalid formatting method: 'p' 0x70." in COM.
o low_get_function_line() now knows about prototypes.
Fixes [bug 4855] ("Bad offset" when generating backtrace).
o Removed spurious call to the fail callback after a successful
Protocols.HTTP.Query()->timed_async_fetch(). Fixes [bug 4773].
o Fixed issue where symbols could be hidden by a later inherit of the
same, but protected, symbol.
o Fixed NULL dereference on failure to resolve the function return
type when functions are used as types.
Optimizations
-------------
o Fixed Filesystem._Tar.ReadFile to not gobble the whole tar entries
into memory at once.
o Improve performance of get_cpu_time() on OS X by avoiding a kernel
trap to get the ID of the underlying system thread.
o Throttle calls to task_info() on OS X since they are quite
expensive. This gives a significant performance boost (>10%) on
CPU-intensive applications.
Extensions and New Functions
----------------------------
o Added support for specifying modifiers via a mapping to '*' in sprintf().
See the documentation for details.
This support is detectable by checking for
String.__HAVE_SPRINTF_STAR_MAPPING__
o Added support for generating little-endian floats with %F in sprintf().
This support is detectable by checking for
String.__HAVE_SPRINTF_NEGATIVE_F__
o Sql.Sql now supports NULL values for %s-parameters.
o Timeout support in win32 threads.
o Made FakeFile() support getchar/gets/unread.
o Added option to chown and utime that makes it possible to change the
symlink instead of the target of the link.
o function_name() now knows how to adjust the names of named lambdas.
o Changed handling of POLLHUP for poll devices, it is now signalled on
all of the callbacks.
o Updated timezone data to tzdata2009c.
o Added some support for the TIMESTAMP and INTERVAL datatypes to
Oracle module.
New modules / classes / methods added
-------------------------------------
o Protocols.IPv6
Helpers for IPv6 related things. This currently only contains tools
to parse and normalize addresses. (Not much more is necessary since
the usual I/O interfaces support IPv6 as-is.)
o Added Filesystem._Tar.extract to be able to extract many/all files
in a reasonably efficient way.
o Added Parser.Tabular
It provides a flexible yet concise record-description language to parse
character/column/delimiter-organised records.
o Calendar.YMD.http_time() that knows how to handle dates according to
HTTP 1.1 (RFC 2616).
o Added support for GTK2 get_window() and get_pixmap().
Building and installing
-----------------------
o Use the #-character as prefix and suffix for placeholders in
master.pike.in instead of the currency sign, to avoid 8-bit character
encoding issues.
o Improved support for version bumping via both Subversion and git.
o A recent stable Pike (7.8.116+) is now required to do a "make
export".
o The win32 installer now removes the generated master.pike on uninstall.
Changes since Pike 7.6:
----------------------------------------------------------------------
This is a high level list of changes between Pike 7.6 and Pike 7.8.
General bug fixes, build fixes and optimizations are not mentioned
here. For a complete list of changes, please consult the CVS changelog
either directly or through Code Librarian.
New / improved language functionality
-------------------------------------
o New syntax to index from the end in range operations.
A "<" can be added before an index in the [..] operator to count
from the end instead, beginning with 0 for the last element. This is
convenient to e.g. chop off the last element in an array: a[..<1].
o New `[..] operator function.
Range operations have been separated from the `[] operator function
and are now handled by the new `[..] which provides greater control
for how the range bounds are specified. For compatibility, if there
is no `[..] then `[] is still called for range operations.
The `[..] callback will get four arguments, start value, start type,
end value and end type. The type arguments is any of
Pike.INDEX_FROM_BEG, Pike.INDEX_FROM_END or Pike.OPEN_BOUND. Here
are a few examples of what input arguments different calls would
generate.
[..] 0 OPEN_BOUND 0 OPEN_BOUND
[1..] 1 INDEX_FROM_BEG 0 OPEN_BOUND
[..2] 0 OPEN_BOUND 2 INDEX_FROM_BEG
[3..4] 3 INDEX_FROM_BEG 4 INDEX_FROM_BEG
[<5..] 5 INDEX_FROM_END 0 OPEN_BOUND
[6..<7] 6 INDEX_FROM_BEG 7 INDEX_FROM_END
o Generalized this and this_program.
It is now possible to refer to inherits in objects. Example:
class A {
int a;
void foo() { werror("A\n"); }
}
class B {
inherit A;
int b;
void foo() { werror("B\n"); }
A::this_program get_a() { return A::this; }
}
In the above B()->get_a() will return an object with two symbols,
'a' and 'foo', but B()->get_a()->foo() will still write "B\n".
o Added support for getters and setters.
It is now possible to simulate variables with functions. Example:
class A {
private int a;
int `b() { return a; } // Getter for the symbol b.
void `b=(int c) { a = c; } // Setter for the symbol b.
int c()
{
return b; // Calls `b().
}
}
object a = A();
a->b = 17; // Calls `b=(17).
werror("%d\n", a->b); // Calls `b().
o Casting to derived types.
It is now possible to call a value of type type to perform the
corresponding value cast. eg:
typedef string MyString;
return MyString(17); // Casts 17 to "17".
o Unicode escapes.
Pike now understands the common way to escape unicode chars, using
\uxxxx and \Uxxxxxxxx escapes. These escapes works both in string
and character literals and in the preprocessor. The latter means
that unicode escapes can be used in identifiers, which is useful if
they contain characters that can't be represented raw in the source
code charset.
o Stricter type checker for function calls.
The type checker for function calls is now based on the concept of
currification. This should provide for error messages that are more
easily understood. It also is much better att typechecking function
calls utilizing the splice (@) operator. The mechanisms used by the
typechecker are also made available as Pike.get_first_arg_type(),
Pike.low_check_call() and Pike.get_return_type().
o Stricter typing of strings.
The string type may now have an optional value range.
string(0..255) bytes;
o Support for having multiple different active backend implementations.
In Pike 7.6 and earlier, there could only be one active backend
implementation at a time, which was the one selected for best
performance with lots of files (cf Pike.Backend below). This led
to problems when Pike attempted to run poll-device based backends
on older versions of operating systems where poll devices aren't
available, and with extra overhead when the backend was only used
with a very small set of files.
Basic backend implementations:
- Pike.PollDeviceBackend
This is a backend that is implemented based on keeping the state in
the operating system kernel and thus eliminating the need to send the
state in every system call. This is however not available on all
operating systems. Currently supported are /dev/poll (Solaris, etc),
epoll(2) (Linux) and kqueue(2) (FreeBSD, MacOS X).
- Pike.PollBackend
This is a backend that is implemented based on the poll(2) system call.
This is typically available on all System V or Linux based systems.
- Pike.SelectBackend
This is a backend that is implmented based on the BSD select(2) system
call. This backend is available on all operating systems supported by
Pike.
Derived backend implementations:
- Pike.Backend
This is the backend selected among the basic backend implementations,
which is likely to have the best performance when there are lots of
files in the backend.
- Pike.SmallBackend
This is the backend selected among the basic backend implementations,
which is likely to have the best performance when there are very few
files in the backend.
Note that there is also a default backend object:
- Pike.DefaultBackend
This is the Pike.Backend object that is used for file callbacks and
call outs if no other backend object has been specified.
o cpp
The preprocessor now supports macro expansion in the #include and #string
directives.
#include USER_SETTINGS
o Destruct reason passed to lfun::destroy.
lfun::destroy now receives an integer flag that tells why the object
is being destructed, e.g. if it was an explicit call to destroy(),
running out of references, or reaped by the garbage collector.
These integers are defined in the new Object module as
DESTRUCT_EXPLICIT, DESTRUCT_NO_REFS, DESTRUCT_GC and
DESTRUCT_CLEANUP.
o Improved support for mixin.
The Pike compiler now supports mixin for symbols that have been
declared protected. Mixin is the concept of overloading symbols
via multiple inheritance. In previous versions of Pike the mixin
paradigm was only supported for public symbols. For more information
about mixin see eg http://en.wikipedia.org/wiki/Mixin .
o Implicit and explicit create().
The compiler now supports defining classes with both an implicit
and an explicit create().
class A (int i)
{
protected string j;
protected void create(string j)
{
A::j = reverse(j);
}
}
o Warnings for unused private symbols.
The compiler now checks that all symbols that have been declared
private actually are used.
o Warnings for unused local variables.
The compiler now checks that all local variables are used.
o Unicode
Case information and the Unicode module are updated to Unicode
5.1.0.
o The keyword protected
The modifier protected is now an alias for the modifier static.
NOTE: In the next release static will be deprecated.
o extern declared variables
Variables can now be declared as 'extern'. This means that
inheriting classes must have them. They can be used like normal
variables in the base class.
Example:
class A
{
extern int a;
int dummy() { return ++a; }
}
o __attribute__ and __deprecated__
It's now possible to set custom attributes on types, so that
it is possible to make custom type checking. This is currently
used to improve the argument checking for sprintf() and related
functions, and for marking symbols as deprecated.
eg:
__deprecated__ mixed obsolete_function();
__deprecated__(mixed) obsolete_return_value();
mixed fun(__deprecated__(mixed) obsolete_arg);
__deprecated__(mixed) obsolete_variable;
The deprecated type flag using __deprecated__ is a convenience
syntax to use instead of e.g.
void f(void|__attribute__("deprecated",int) timeout)
Other uses of __attribute__ in type declarations can be seen in e.g.
the type for werror():
> typeof(werror);
(1) Result: scope(0,function(string : int) |
function(__attribute__("sprintf_format", string),
__attribute__("sprintf_args", mixed) ... : int) |
function(array(string), mixed ... : int))
o __func__
The symbol __func__ now evaluates to the name of the current
function. Note that this name currently can differ from the
declared name in case of local functions (i.e. lambdas). Note
also that __func__ behaves like a literal string, so implicit
string concatenation is supported. eg:
error("Error in " __func__ ".\n");
o __DIR__
__DIR__ is a new preprocessor symbol that resolves to the directory
that the current file is placed in. Similar to how __FILE__ points
out the file the code is placed in.
o #pragma {no_,}deprecation_warnings
Warnings for use of deprecated symbols can be turned off for a
segment of code with
#pragma no_deprecation_warnings
and turned on again with
#pragma deprecation_warnings
o Compatibility name spaces
Older versions of a function can be reached through its version name
space. For example the 7.4 version of the hash function can be
called through 7.4::hash().
o Iterator API
The iterator API method Iterator->next() is no longer optional.
o IPv6
Support for IPv6 has been improved.
Extensions and New Functions
----------------------------
o exit()
Exit now takes optional arguments to act as a werror in addition to
exiting the process.
exit(1, "Error while opening file %s: %s\n", path, strerror(errno()));
o getenv()/putenv()
getenv() and putenv() are now accessing and modifying the real
environment.
o get_dir()
Calling get_dir() with no arguments will now return the directory
listing for the current directory.
o undefinedp()/destructedp()
undefinedp() and destructedp() have been added as more readable
alternatives to zero_type().
o limit()
The new toplevel function limit(a, x, b) is a convenience function
that works like min(max(a,x),b).
o listxattr(), getxattr(), setxattr(), removexattr()
The new xattr functions listxattr(), getxattr(), setxattr and
removexattr() allows extended file attributes to be modified from
within Pike.
o sprintf() and sscanf()
- sprintf() now attempts to lookup the name of the program when
formatting types of objects and programs.
- The new formatting directive %H can be used to format a string as
a binary hollerith string.
> sprintf("%2H", "Hello");
(1) Result: "\0\5Hello"
- The new formatting directive %q can be used to format a atring as
a quoted string, quoting all control character and non-8-bit
characters as well as quote characters. Like %O but always on one
line.
> sprintf("%q", "abc \x00 \" \' \12345");
(1) Result: "\"abc \\0 \\\" ' \\u14e5\""
- Ranges in sscanf sets can now start with ^, even at the beginning
of the set specifier. Example: %[^-^] matches a set with only ^ in
it. To negate a set with - in it, the - character must now be the
last character in the set specifier.
o encode/decode value and programs
--with-portable-bytecode is now the default. Pike programs that have
been dumped on one architecture now can be decoded on another.
o gethrtime, gethrvtime, gauge
Added support for POSIX style timers using clock_gettime(3). Notably
this fixes nice high resolution thread local cpu time and monotonic
real time on reasonably modern Linux systems.
There are new constants CPU_TIME_* and REAL_TIME_* in the System
module to allow pike code to query various properties of the CPU and
real time clocks in use.
o ADT.BitBuffer
Added read() method that reads whole bytes from the buffer and
returns as a string.
o ADT.Queue
It is now possible to use sizeof() and values() on a Queue object to
get the size of the queue and all elements in the queue as an array.
o ADT.Stack
Stack objects can now be cast to arrays to get all elements on the
stack.
o ADT.Struct
- New Item class SByte, SWord and SLong represents a signed byte,
word and longword respectively.
- The Item classes int8, uint8, int16, uint16, int32, uint32, int64
and uint64 are aliases for already existing Item classes.
- sizeof() now works for empty Struct objects.
- sizeof() can be used on individual Item objects.
- Struct objects can now be used as Items in other Structs.
class Pair
{
inherit ADT.Struct;
Item id = uint8();
Item val = uint64();
}
class File
{
inherit ADT.Struct;
Item magic = Chars(4);
Item one = Pair();
Item two = Pair();
}
o Array
- New function combinations() returns all combinations of a
specified length with elements from a given array.
- Added push(), pop(), shift() and unshift() functions for Perl
weirdos.
o Calendar
- Added new calendar Badi, used in the Baha'i religion.
- Fixed bugs in discordian, where the year() was off by 1166 and
now() was off 5 month per year.
- Time objects now handle * and / with floats. A split() method has
been added for more advanced splitting where the preferred time
quanta can be given as an argument.
- A new formatting method format_ext_time_short() has been added to
Time objects.
- Timezones are now read from /etc/localtime, if available.
- Cleaned up year-day (yd) handling so that it never goes below 1.
Instead be careful to use either year (y) or week-year (wy)
depending on context.
- Fixed inconsistent range handling in year() and years() that made
them almost but not quite zero-based. Now they are one-based just
like day()/days(), month()/months() etc.
- Cleaned up conversion between weeks and years: E.g. if a week has
days in two years then converting it to years will produce a range
of both years. The attempt to always map a week to a single year
is gone since it's inconsistent with how other overlapping time
ranges are handled. If the user wants to convert a week to the
year it "unambiguously" belongs to, (s)he can do
Calendar.ISO.Year(week->year_no()).
- Did away with the attempt to map leap days between February 24th
and 29th before and after year 2000, since doing so breaks date
arithmetic.
- The last four changes above are not entirely compatible.
Compatibility with 7.6 and older is retained with #pike 7.6.
o CompilerEnvironment & CompilerEnvironment()->PikeCompiler
The Pike compiler has been refactored to be more object-oriented and
more transparent. It is now possible to customize the compiler by
overloading functions in the above two classes. The compiler object
used by Pike internally is available through the global constant
DefaultCompilerEnvironment.
o Debug
The new function count_objects() will return the different kinds of
objects existing within the Pike process. Useful when trying to
pinpoint a leak of Pike objects.
o Error
The new function mkerror() will normalize any thrown value into a
proper error object (or 0).
o Filesystem
Traversion has been extended with two new create arguments. The
first one is a flag to supress errors and the other is a sorting
function which will be applied to the entries in every directory.
This callback can also be used to filter the directory entries.
o Float
The function isnan() can be used to check if a float is Not a
Number.
> Float.isnan(Math.inf/Math.inf);
(1) Result: 1
o Gdbm
Gdbm databases can be opened in synchronous mode or locking mode by
adding "s" or "l" respectively in the mode parameter to the create
method.
o Geography.Position
It is now possible to encode Position objects with encode_value().
o GLUE
- The default event callback will now exit both on Exit and Escape
events.
- The texture, list and light id generators will now be created
after we are sure that GL has been initialized, to prevent crashes
on several systems.
- BaseTexture and BaseDWIM now supports clamped textures.
o Gmp
Many small changes to fix Gmp build issues on different platforms.
The most visible being that the Gmp module now is statically linked
to work around Mac OS X 10.5 linker issues.
o Gz
- Added compress() and uncompress() functions as a simpler and more
efficient but non-streaming interface.
- Support for RLE And FIXED compression method, if supported by
zlib. Give Gz.RLE or Gz.FIXED to the strategy argument of
compress() or the deflate constructor.
- Added support for configurable compression window size. This is
the last argument to compress() and the constructor for
inflate/deflate.
o Image.Colortable
- The new method greyp() can be used to query if the color in the
color object is grey.
- Partial support for serializing color objects. Dithering type and
lookup mode is not currently saved.
o Image.Dims
Support for parsing out the dimensions of TIFF files has been added.
o Image.FreeType
- Added support for handling monochrome (bitmap) fonts.
o Image.Image
- Image object can now be serialized and deserialized with
encode_value() and decode_value().
- It is possible to convert the colors in an image object to and
from YUV (YCrCb) with the new rgb_to_yuv() and yuv_to_rgb()
methods.
o Image.Layer
- It is now possible to get the raw bitmap data of a layer by
casting the layer object to a string.
o Image.PNG
- Properly decode cHRM (chrome), sBIT (sbit), gAMA (gamma), pHYs
(physical), oFFs (offset), tIME (time) chunks.
- The compression level and strategy when compressing PNG images can
be controlled by passing "zlevel" and "zstrategy" options to the
encode() method. Available strategies are filtered, huffman, rle
and fixed.
Image.PNG.encode( img, ([ "zlevel":9, "zstrategy":Gz.RLE ]) );
o Image.TIFF
Added support for little endian TIFF files.
o Int
Int.inf is an object that can be used as an infinitly large integer.
o Java
- If possible, Pike now uses libffi instead of creating our own
trampolines. Adding libffi as a bundle is supported.
- Added built-in support for SPARC64 trampolines.
- The method signature fuzzy-matcher now only considers Pike strings
to match formal parameters of type String, Object, Comparable,
CharSequence or java.io.Serializable.
- When the fuzzy-matcher can not decide on a single method
signature, all candidates are now listed in the error message.
o Locale.Charset
- The character name normalizer now recognizes Unicode prefixes,
e.g. "unicode-1-1-utf-7", though the Unicode version itself is
ignored.
- Added support for the following character sets
GB18030/GBK (CP936)
UTF-EBCDIC
DIN-31624 (ISO-IR-38)
ISO-5426:1980 (ISO-IR-53)
ISO-6438:1996 (ISO-IR-39, ISO-IR-216)
ISO-6937:2001 (ISO-IR-156)
GSM 03.38
Mysql Latin 1
- Added typed encode and decode error objects,
Locale.Charset.EncodeError and Locale.Charset.DecodeError, to make
it possible to catch such errors in a better way.
- ISO-IR non-spacers are now converted into combiners.
o Math
- Matrix multiplication was bugged and gave B*A instead of A*B,
which is now fixed.
- Matrix objects now have xsize() and ysize() methods to query their
dimensions.
- To ease your logarithmic needs log2() and logn() have been added.
o MIME
- Added remapping variants of the encode words functions with
encode_word_text_remapped(), encode_word_quoted(),
encode_words_quoted_remapped() and
encode_words_quoted_labled_remapped().
- Added workaround for a bug in Microsoft Internet Explorer where it
forgets to properly quote backslashes in the Content-Disposition
field.
- Fixed a bug that could occur when casting MIME.Message objects to
strings.
o Mysql
- Two functions set_charset() and get_charset() have been added to
set and query the connection charset. The create() function also
takes a "charset" setting in the options mapping.
- Improved Unicode support. The MySQL driver now supports
(possibly wide) Unicode queries and text return values, handling
the connection charset and all encoding/decoding internally. This
is enabled by setting the charset to "unicode", or through the new
functions set_unicode_encode_mode() and set_unicode_decode_mode().
See their documentation for further details.
o Odbc
The Odbc module has been updated to support the UnixODBC library, and
several issues with Unicode and FreeTDS handling have been fixed.
o Oracle
- The module has been updated to work with Oracle 10.
- An approximation of the number of rows in a result object can be
queried from the new function num_rows().
o Parser.HTML
- Allow string and array as argument to _set_*_callback(). Those
variants work just like a function only returning the string or
array.
o Parser.Pike and Parser.C
- Parser.Pike and Parser.C have been rewritten in C for increased
performance.
- The #string directives should be handled correctly now.
o Parser.RCS
- The RCS parser has been rewritten to be more robust with regards
to broken RCS data.
o Parser.XML.NSTree
- Added add_child_before() and add_child_after() methods to the
NSNode object.
o Parser.XML.Simple
- The autoconvert() function, used to autodetect the character
encoding of an XML file and decode it, has been moved from being a
method of the Parser.XML.Simple object to being a function in the
Parser.XML module.
o Parser.XML.SloppyDOM
Yet another DOM-like module aimed at quickly and conveniently parse
an xml snippet (or whole document) to access its parts. Nodes can be
selected using a subset of XPath.
Footnote: This module was previously part of Roxen WebServer.
o Parser.XML.Tree
The module code has been refactored and a second "simple" interface
has been added. The (new) SimpleNode interface implements a node tree
interface similar to the (old) Node interface, with two major
differences:
- The SimpleNodes do not have parent pointers, this means that they
do not generate cyclic data structures (and thus less garbage, and
no need for zap_tree()), but also that it is no longer possible to
find the root of a tree from any node in the tree.
- Some methods in SimpleNode return different values than the
corresponding method in Node; notably SimpleNode()->add_child(),
which returns the current node rather than the argument.
The refactoring also added individual classes for all of the XML node
types (both for Nodes and for SimpleNodes). This allows for stricter
typing of code involving XML tree manipulation.
Several new functions added to manipulate and insert nodes in the
XML tree.
The module now also has a much better knowledge of DTDs and DOCTYPEs.
o Parser.XML.Validating
- get_external_entity() now gets the callback info mapping as
the third argument rather than a constant zero.
- SYSTEM URIs are now normalized during parsing if possible.
- parse() and parse_dtd() now accept getting the base URI for the
parsed data as the second argument.
- Improved error reporting.
- Several issues with the parsing of DTDs have been fixed.
o Postgres
- Extended the SQL query interface to include affected_rows() and
streaming_query() as well as variable bindings.
- Automatic binary or text transfer for queryarguments and resultrows.
Note: A new native Postgres driver has also been added; see
Sql.pgsql.
o Pike
- A new function count_memory() has been added which can calculate
the memory consumed by arbitrary data structures. Useful when
implementing memory caches.
- A new function get_runtime_info() has been added which returns
information about current ABI, if automatic bignums are enabled,
what bytecode method is used, the size of native floats and
integers and the native byte order.
- The constants INDEX_FROM_BEG, INDEX_FROM_END and OPEN_BOUND has
been added for use with the `[..] operator API.
- The functions low_check_call(), get_return_type() and
get_first_arg_type() allows for inspection of attributes and
return values of functions.
o Pike.Backend
Besides the new multiple backend implementations described earlier,
backends now support two new callbacks: before_callback and
after_callback are two new variables in the backend objects. They
can be set to functions that gets called just before and after a
backend is waiting for events.
o Process
- The new function spawn_pike() will spawn a Pike process similar to
the current one, using the same binary file, master and module
paths.
- The new function run() is an easy interface that will run a
process and return a mapping with all the outputs and exit code.
- Process.popen is now able to run in nonblocking mode. If a second
argument is provided a file object will be opened with that mode
and return, enabling two way communication with the new process.
- The system() function has been extended to be able to pass stdin,
stdout and stderr arguments to the spawn() call it performs.
o Protocols.DNS
- Added support for NAPTR (RFC 3403) and SPF (RFC 4408) records.
- The gethostbyname() function now returns IPv6 addresses too, if
available.
- Fixed bugs in IPv6 record parsing.
o Protocols.Bittorrent
- Support for gzipped and compact tracker responses.
- Many performance and bug fixes, such as 30% faster hashing of
files.
o Protocols.HTTP
- Added support for httpu and httpmu requests.
- Queries will now throw an exception in case of an errno condition.
- A new function, do_async_method(), has been added to allow access
to low level asynchronous HTTP calls.
- The http_encode_string() function now knows how to encode UCS-2
characters.
o Protocols.HTTP.Server
- If accept() fails on the open port, the Port object will continue
trying, to support servers with high load.
o Protocols.HTTP.Query
- Added unicode_data() method that will return the payload decoded
according to the charset described in the Content-Type header.
- Many fixes for bugs in asynchronous mode.
- A query will not silently downgrade to http from https anymore if
there is no crypto support.
- Fixes for keep alive.
- IPv6 fixes in DNS handling.
o Protocols.LDAP
- Enabled support for paged queries.
- Added more resilience to UTF-8 encode errors.
Locale.Charset.DecodeError is thrown for UTF-8 decode exceptions.
- Added a connection pool for connection reuse. It is used through
get_connection() and return_connection().
- Added some schema handling and use it to fix the UTF-8 conversion
to only affect attributes that actually are UTF-8 encoded.
- Added client.read(), client.read_attr(),
client.get_root_dse_attr(), client.get_basedn(),
client.get_scope(), client.get_attr_type_descr(),
get_constant_name(), and a bunch of constants for various object
oids, attributes, well-known object guids and other things.
- Rewrote the search filter parser to handle LDAPv3 extensible
matches. It now also throw errors on all syntactic errors (using a
new FilterError object), instead of sending a partial filter to
the server. It is also possible to compile filters separately
through make_filter(), and there is a very simple cache for
compiled filters through get_cached_filter().
- Added ldap_encode_string(), ldap_decode_string(),
encode_dn_value(), canonicalize_dn(), parse_ldap_url(),
client.get_parsed_url(), and client.get_bound_dn().
- Added client.result.fetch_all().
- Added new flag field to client.search() to control various aspects
of how results are returned: SEARCH_LOWER_ATTRS lowercases all
attribute names. SEARCH_MULTIVAL_ARRAYS_ONLY uses arrays for
attribute values only for attributes that might return more than
one value. SEARCH_RETURN_DECODE_ERRORS may be used to avoid
throwing exceptions on decode errors.
- Added client.get_protocol_version(),
client.get_supported_controls(), and the possibility to specify
controls in client.search().
- Made the result iterator somewhat more convenient: next() now
advances one step past the end so the next fetch() returns zero.
- Added client.error_number(), client.error_string(), and
client.server_error_string() to make it possible to query errors
when no result object is returned.
o Protocols.SNMP
The readmsg() method in the protocol object now takes an optional
timout argument.
o Protocols.TELNET.Readline
Several issues where callback functions could be lost have been fixed.
o Protocols.XMLRPC
The new AsyncClient class implements an asynchronous XMLRPC client.
o Regexp.PCRE.Widestring
- Replace matches in a string, with support for backreferences, now
possible from replace_positional().
> Regexp.PCRE.Plain("my name is ([a-zA-Z]+)")->
>> replace_positional("hello, my name is john.",
>> "%[0]s is my name");
(1) Result: "hello, john is my name."
- Regexp.PCRE.Widestring is now reported in the basic feature list
(pike --features).
o Sql
- Bugfixes in listing Postgres fields.
- If ENABLE_SPAWN_RSQLD is defined, rsqld will be spawned when
needed to complete rsql queries.
- Added streaming_query() method to Sql objects which enables larger
result sets than available memory.
- It is possible to iterate over the result object from big_query()
queries directly in foreach.
- Support UNDEFINED to designate NULL in emulated bindings.
- Support for ODBC DSN files.
Sql.Sql db = Sql.Sql("dsn://user:pass@host/database");
- Some native support for the TDS protocol, used by Sybase and
Microsoft SQL server.
Sql.Sql db = Sql.Sql("tds://user:pass@host/database");
- Support for the SQLite database added. A raw interface is
available through the SQLite module.
Sql.Sql db = Sql.Sql("sqlite://relative/path/to/file");
Sql.Sql db = Sql.Sql("sqlite:///absolute/path/to/file");
- Sql.pgsql. New driver for native PostgreSQL network protocol support.
It implements a superset of the existing Postgres driver.
Current features: no library dependencies (no libpq), native binding
support, streaming support, NOTIFY/LISTEN support (fully eventdriven,
no polling), binary support for integer, float and string datatypes
through big_typed_query(), native support for 64-bit ints and doubles,
COPY FROM/TO STDIN/STDOUT support, multiple simultaneous streaming
queries on the same connection (i.e. multiple PostgreSQL-portal-
support), automatic precompilation and caching of often-used
long-compile-time-needing queries, extended columndescriptions,
accurate error messages under all circumstances, SSL-support,
SQL-injection protection since it will ignore everything after the
first semicolon delimiting the first command in the query, integrated
statistics, _reconnect callback for sessions that use temptables.
Performance tuned, with the helperclass _PGsql.PGsql it currently
is around 21% faster than the old libpq based Postgres driver
for smaller queries; for large bytea blobs and large texts, it
speeds up even more.
This driver serves URLs of the form:
pgsql:// (plain) and pgsqls:// (SSL).
In case the old Postgres driver is disabled, this driver takes
over postgres:// transparently as well.
o SSL
It is now possible to set certificates to SSL connections. Example:
SSL.sslfile ssl_connection(Stdio.File conn, string my_key,
string my_certificate)
{
ctx->client_rsa = Standards.PKCS.RSA.parse_private_key(my_key);
// client_certificates is an array holding arrays of certificate
// chains. since we've got a self-signed cert, our cert array has
// only 1 element.
ctx->client_certificates += ({ ({ my_certificate }) });
return SSL.sslfile(conn, ctx, 1, 1);
}
o Standards.IIM
Some bugfixes in parsing Photoshop headers and DOS EPS Binary
Headers.
o Standards.ISO639_2
Updated with the latest ISO639-2 languages.
o Standards.URI
- Updated to conform to RFC 3986.
- Added methods get_query_variables(), set_query_variables(),
add_query_variable() and add_query_variables() to give a better
API to to handle query variables.
- The new method get_http_query() returns the query part and
get_http_path_query() returns both the path and the query, both
coded according to RFC 1738.
o Standards.UUID
- Added support for UUID version 5; name based with SHA hash, which
can be generated from the make_version5 function.
- An UUID object can now be used as namespace in the second argument
to make_version3 as well as the new make_version5.
o Standards.XML.Wix
- Updated to support a more recent version of the Wix tool chain.
- Improved generation of 8.3-style filenames.
- Added support for Shortcut and IniFile-nodes.
- Added support for overriding the language and installer version.
- Improved support for TTF-files.
o Stdio
- Stdio.cp can now work recursively in a directory tree. It will
also keep the permissions of files it copies.
- Added Stdio.recursive_mv which works on every OS and also when the
destination isn't on the same filesystem as the source.
- Added more symbolc default termcap/terminfo bindings to
Stdio.Readline.
- Improved support for Stdio.Terminfo on NetBSD.
- read_file(), read_bytes(), write_file() and append_file() will may
now throw exceptions on uncommon errors such as when write_file is
unable to write all its data.
- Stdio.File->openat(), statat() and unlinkat() opens, stats and
removes a file or directory relative to an open directory.
- Stdio.FILE->unread() allows pushing back binary strings into the
input stream, as opposed to ungets() which pushes back lines.
- Stdio.UDP has had enable_multicast(), set_multicast_ttl(),
add_membership() and drop_membership() added to make real
multicast use possible.
o String
- The function int2size has been rewritten to fixpoint as well as
using the more common abbreviation of "B" for byte.
- String.secure marks a string as "secure" which currently only
means that the memory is cleared before it is freed.
o System
- resolvepath() is now enabled on more OSes and falls back to
realpath(3C) if resolvepath(2) doesn't exists.
- On systems that support it, setproctitle() can be used to set the
title of the running application.
- Added support for POSIX style timers using clock_gettime(3) to
allow for high resolution thread local cpu time and monotonic real
time on reasonable modern Linux systems for gethrvtime() and
gauge(). Added CPU_TIME_RESOLUTION, CPU_TIME_IMPLEMENTATION,
REAL_TIME_IS_MONOTONIC, REAL_TIME_RESOLUTION and
REAL_TIME_IMPLEMENTATION constants to tell the system
capabilities.
o Tools.Hilfe
- Added support for tab-completion on modules, global and local
symbols and operators.
- Added support for file/directory completion within strings
- Added doc command and F1 key to print documentation on an item if
available (currently only works for modules and classes written in
pike).
o Tools.Standalone
- "pike -x cgrep" now tries to parse Java code.
- "pike -x features" now tests for several more features.
o Web.Crawler
- Bugfix to support robots.txt created on windows.
- User Agent change to "Mozilla 4.0 (PikeCrawler)"
o Web.RDF
- Added add_statement() method which allows new relations to be
added to an RDF set.
New modules / classes / methods added
-------------------------------------
o Fuse
FUSE (Filesystem in USErspace) provides a simple interface for
userspace programs to export a virtual filesystem to the Linux
kernel (and some other OS:es). FUSE also aims to provide a secure
method for non privileged users to create and mount their own
filesystem implementations.
This module implements the needed interfaces to make it possible to
write a FUSE filesystem in Pike.
o ADT.List
A simple doubly linked list of values.
ADT.List l = ADT.List(1, 2, 3);
l->insert(-1, 0);
l->append(4, 5);
foreach(l; int index; int value) {
werror(" %d: value: %d\n", index, value);
}
o ADT.Set
ADT.Set implements a datatype for sets. These sets behave much
like multisets, except that they are restricted to containing only
one instance of each member value.
From a performance viewpoint, it is probably more efficient for a
Pike program to use mappings to serve as sets, rather than using an
ADT.Set, so ADT.Set is mainly provided for the sake of completeness
and code readability.
o Arg
The new argument parser module allows for Getopt style argument
parsing, but with a much simpler and object oriented API.
class Parser
{
inherit Arg.Options;
Opt verbose = NoOpt("-v")|NoOpt("--verbose")|Env("VERBOSE");
Opt name = HasOpt("-f")|HasOpt("--file")|Default("out");
Opt debug = MaybeOpt("-d")|MaybeOpt("--debug");
}
void main(int argc, array(string) argv)
{
Parser p = Parser(argv);
werror("name: %O, verbose: %O, debug: %O\n",
p->name, p->verbose, p->debug);
}
A more simplistic interface is also available for smaller hacks and
programs.
void main(int argc, array(string) argv)
{
mapping opts = Arg.parse(argv);
argv = opts[Arg.REST];
}
o GSSAPI
Implements Pike access to GSS-API v2 as specified in RFC 2743. This
API is used to authenticate users and servers, and optionally also
to encrypt communication between them. The API is generic and can be
used without any knowledge of the actual implementation of these
security services, which is typically provided by the operating
system.
The most common implementation is Kerberos, which means that the
main benefit of this API is to allow clients and servers to
authenticate each other using Kerberos, thereby making single
sign-on possible in a Kerberized environment.
o GTK2
Wrapper for the GTK2 library. Not yet 100% completed, but usable.
o Protocols.DNS_SD
This module provides an interface to DNS Service Discovery. The
functionality of DNS-SD is described at <http://www.dns-sd.org/>.
Using the Proctocols.DNS_SD.Service class a Pike program can
announce services, for example a web site or a database server, to
computers on the local network.
When registering a service you need to provide the service name.
service type, domain and port number. You can also optionally
specify a TXT record. The contents of the TXT record varies between
different services; for example, a web server can announce a path
to a web page, and a printer spooler is able to list printer
features such as color support or two-sided printing.
The service is registered on the network for as long as the instance
of the Service class is valid.
o Bittorrent.Tracker
Bittorrent tracker with support for scraping and UDP extension.
o Protocols.HTTP.Server.Proxy
A simple HTTP proxy.
o Standards.TLD
Country domains and other TLDs according to IANA. Useful when
parsing log information or providing live information about clients
connecting to your server.
o Tools.Shoot
Several new tests have been added to benchmark and improve on
various aspects of Pike. ReplaceParallel and ReplaceSerial measure
the times it takes to replace multiple substrings of a string in a
single call to replace and with subsequent calls.
TagRemoveArraySscanf, TagRemoveDivide, TagRemoveLoop,
TagRemoveParserHTML, TagRemovePCRE, TagRemoveSearch and
TagRemoveSscanf measure different methods of completing the same
task; to remove XML tags from a string.
o Web.CGI
Provides a CGI interface on the callee side. Retrieves information
from environment variables and populates the variables in the
Request object.
Deprecations
------------
o The keyword nomask has been deprecated. It was functionally
equivivalent with the keyword final.
o Stdio.File->set_peek_file_before_read_callback() is deprecated.
Incompatible changes
--------------------
These incompatible changes can be solved by adding #pike 7.6 to your
source file or starting Pike with -V7.6 unless otherwise noted.
o main() environment
The main() method will no longer be given the environment as a
mapping as third argument. Use an explicit call to getenv() instead.
o Array.transpose_old
This function has been removed.
o Calendar
Changes made to fix inconsistensies has created som unavoidable
incompatibilities. See the entry for Calendar in the functional
changes section for details.
o _Charset
The parts of this internal module that were written in Pike
have moved to Locale.Charset.
o Crypto
The old crypto functions from Pike 7.4 have been removed. These
functions produced a warning when used in Pike 7.6.
o Debug.describe_program
The API for this debug function has changed.
o Image.Image
The functions select_colors(), map_closest(), map_fast() and
map_fs() has been removed. Use Image.Colortable operations instead.
o Parser.XML
The XML parsers are now stricter in verifying the correctness
of the XML. The function compat_allow_errors can be called in the
create method of the Parser.XML.Simple and Parser.XML.Validating
(with "7.6" as argument for 7.6 compatibility). Parser.XML.Tree can
be created with PARSE_COMPAT_ALLOW_ERRORS_7_6 as flag.
o Protocols.LDAP.client
The "dn" field wasn't properly utf-8 decoded in 7.6 and earlier. If
your application does it yourself, you need to use the compatibility
version of this class.
o Protocols.TELNET
The interface functions create() and setup() are now protected symbols.
o spider.XML
The spider module no longer contains the XML parser. The functions
isbasechar(), iscombiningchar(), isdigit(), isextender(),
isfirstnamechar(), ishexchar(), isidiographic(), isletter(),
isnamechar() and isspace() have also been moved to the Parser module.
o Sql.Sql
Pike will no longer create a .column entry in SQL query responses if
there is no table name.
o Standards.UUID
Functions new() and new_string() have been removed. Use
make_version1(-1)->encode() and make_version1(-1)->str() instead.
o Stdio
The functions read_file(), read_bytes(), write_file() and
append_file() now always throw errors on error conditions,
to allow easier use as errno doesn't have to be checked.
read_file() and read_bytes() still return 0 if the file
does not exist.
o The modules Mird, Perl and Ssleay have been removed.
Note that these modules are not available via the backwards
compatibility layer.
C level module API
------------------
o Improved support for embedding.
Several declarations and definitions (most notably the debug and
runtime flags) have moved from main.h to pike_embed.h, in an attempt
to add support for embedding.
o Major compiler API cleanups.
The Pike compiler is now executing in a pike function context
(rather than in an efun context), and it is possible to customize
some of its behaviour via inherit (rather than via handler objects).
As a consequence the compiler is now much closer to being thread-safe.
o The global variable next_timeout is no more. It has been replaced by
a backend-specific variable. Added backend_lower_timeout() for accessing
the new variable. This fixes issues GTK, GTK2 and sendfile had with the
new backend implementation.
NOTE! C-API incompatibility!
NOTE! Changed the argument for backend callbacks!
The argument is now a struct Backend_struct * when called
at entry (was NULL).
The argument is now NULL when called at exit (was 1).
o Pike_fp->context
Pike_fp->context is now a pointer to the current struct inherit
rather than a copy of it. This allows for easier access to
inherited symbols in C-code.
o Inherit level argument added to several object handling functions.
In order to implement subtyping of objects, an extra argument
"inherit_level" has been added to many object indexing related
functions.
o .cmod:
Voidable pointer types are no longer promoted to mixed.
o Support for class symbols with storage in parent scope.
Also added support for aliased symbols.
o Machine code backend for PPC64
- Machine code generation is now supported for PowerPC in
64-bit ABI mode.
o Objectiv-C embedding framwork
- Experimental support for interfacing with Objective-C code
has been added.
NOTE! This API is experimental and is subject to change
NOTE! without notice.
o Added %c and %C to get_all_args to get char * without
NUL characters (no 0 valued characters inside the string).
%c: char * Only narrow (8 bit) strings without NUL.
This is identical to %s.
%C: char * or NULL Only narrow (8 bit) strings without NUL, or 0
Building and installing
-----------------------
o Dynamic modules now become DLLs on Windows.
This means the homegrown module loader is no longer used, but it
also means some DLL limitations:
- PMOD_EXPORT is now required to allow access to an identifier in
the pike core.
- DLLs have to be recompiled too if pike.exe is recompiled.
The primary motivation for this change is to work with the new
library tracking (so-called "side-by-side assemblies") in Visual C++
2005 and later.
o Added ABI selection.
It's now possible to select whether to compile in 32bit or 64bit
mode at configure time by using the --with-abi option.
o MinGW builds.
It's now possible to build Pike in MinGW on windows computers from
source distributions.
o Cmod precompiler.
- The cmod precompiler (pike -x precompile) now supports declaring
all autogenerated identifiers as static.
NOTE! C-API incompatibility!
NOTE! As a side effect of this change, the DECLARATIONS statement
NOTE! now required in cmod files.
New simplified method to write external C/C++ modules
-----------------------------------------------------
It's now suggested that you do not use the fairly complex 'pike
internal' style of external modules (configure.in with
AC_MODULE_INIT etc).
It's also no longer required that you have a configure script to use
pike -x module.
Instead simply locate the includefiles using 'pike -x cflags', and
convert .cmod to .c files using 'pike -x precompile'.
An example rather minimal 'pike -x module' compatible Makefile,
without a configure script, using .cmod format files for a simple
local module:
| CC=gcc
| CFLAGS := -O9 -fweb -shared -Wall $(CFLAGS) $(shell $(PIKE) -x cflags) -g
| LD=$(CC) -shared -lGL
|
| all: Spike.so
|
| install: Spike.so
| cp $< $(MODULE_INSTALL_DIR)
|
| Spike.so: Spike.o
| $(LD) -o Spike.so Spike.o $(LDFLAGS)
|
| Spike.o: Spike.c
|
| Spike.c: Spike.cmod
| $(PIKE) -x precompile $< > $@
It's usually OK not to use pike -x module at all, but it will pass
on a few extra variables to your make (and configure script):
PIKE: How to start the pike interpreter used running pike -x module
MODULE_INSTALL_DIR: Where modules goes
LOCAL_MODULE_PATH: Alternative (user local) module location