The R13B03 release.OTP_R13B03

1 files changed, 421 insertions, 0 deletions

diff --git a/erts/preloaded/src/zlib.erl b/erts/preloaded/src/zlib.erl
new file mode 100644
index 0000000000..21971a75cf
--- /dev/null
+++ b/erts/preloaded/src/zlib.erl
@@ -0,0 +1,421 @@
+%%
+%% %CopyrightBegin%
+%% 
+%% Copyright Ericsson AB 2003-2009. All Rights Reserved.
+%% 
+%% The contents of this file are subject to the Erlang Public License,
+%% Version 1.1, (the "License"); you may not use this file except in
+%% compliance with the License. You should have received a copy of the
+%% Erlang Public License along with this software. If not, it can be
+%% retrieved online at http://www.erlang.org/.
+%% 
+%% Software distributed under the License is distributed on an "AS IS"
+%% basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
+%% the License for the specific language governing rights and limitations
+%% under the License.
+%% 
+%% %CopyrightEnd%
+%%
+
+-module(zlib).
+
+-export([open/0,close/1,deflateInit/1,deflateInit/2,deflateInit/6,
+	 deflateSetDictionary/2,deflateReset/1,deflateParams/3,
+	 deflate/2,deflate/3,deflateEnd/1,
+	 inflateInit/1,inflateInit/2,inflateSetDictionary/2,
+	 inflateSync/1,inflateReset/1,inflate/2,inflateEnd/1,
+	 setBufSize/2,getBufSize/1,
+	 crc32/1,crc32/2,crc32/3,adler32/2,adler32/3,getQSize/1,
+	 crc32_combine/4,adler32_combine/4,
+	 compress/1,uncompress/1,zip/1,unzip/1,
+	 gzip/1,gunzip/1]).
+
+%% flush argument encoding
+-define(Z_NO_FLUSH,      0).
+-define(Z_SYNC_FLUSH,    2).
+-define(Z_FULL_FLUSH,    3).
+-define(Z_FINISH,        4).
+
+%% compression level
+-define(Z_NO_COMPRESSION,         0).
+-define(Z_BEST_SPEED,             1).
+-define(Z_BEST_COMPRESSION,       9).
+-define(Z_DEFAULT_COMPRESSION,  (-1)).
+
+%% compresssion strategy
+-define(Z_FILTERED,            1).
+-define(Z_HUFFMAN_ONLY,        2).
+-define(Z_DEFAULT_STRATEGY,    0).
+
+%% deflate compression method
+-define(Z_DEFLATED,  8).
+
+-define(Z_NULL, 0).
+
+-define(MAX_WBITS, 15).
+
+%% gzip defs (rfc 1952)
+
+-define(ID1, 16#1f).
+-define(ID2, 16#8b).
+
+-define(FTEXT,     16#01).
+-define(FHCRC,     16#02).
+-define(FEXTRA,    16#04).
+-define(FNAME,     16#08).
+-define(FCOMMENT,  16#10).
+-define(RESERVED,  16#E0).
+
+-define(OS_MDDOS,   0).
+-define(OS_AMIGA,   1).
+-define(OS_OPENVMS, 2).
+-define(OS_UNIX,    3).
+-define(OS_VMCMS,   4).
+-define(OS_ATARI,   5).
+-define(OS_OS2,     6).
+-define(OS_MAC,     7).
+-define(OS_ZSYS,    8).
+-define(OS_CPM,     9).
+-define(OS_TOP20,  10).
+-define(OS_NTFS,   11).
+-define(OS_QDOS,   12).
+-define(OS_ACORN,  13).
+-define(OS_UNKNOWN,255).
+
+-define(DEFLATE_INIT,    1).
+-define(DEFLATE_INIT2,   2).
+-define(DEFLATE_SETDICT, 3).
+-define(DEFLATE_RESET,   4).
+-define(DEFLATE_END,     5).
+-define(DEFLATE_PARAMS,  6).
+-define(DEFLATE,         7).
+
+-define(INFLATE_INIT,    8).
+-define(INFLATE_INIT2,   9).
+-define(INFLATE_SETDICT, 10).
+-define(INFLATE_SYNC,    11).
+-define(INFLATE_RESET,   12).
+-define(INFLATE_END,     13).
+-define(INFLATE,         14).
+
+-define(CRC32_0,         15).
+-define(CRC32_1,         16).
+-define(CRC32_2,         17).
+
+-define(SET_BUFSZ,       18).
+-define(GET_BUFSZ,       19).
+-define(GET_QSIZE,       20).
+
+-define(ADLER32_1,       21).
+-define(ADLER32_2,       22).
+
+-define(CRC32_COMBINE,   23).
+-define(ADLER32_COMBINE, 24).
+
+%%------------------------------------------------------------------------
+
+%% Main data types of the file
+-type(iodata()      :: iolist() | binary()).	%XXX To be removed in R13B.
+-type zstream()     :: port().
+
+%% Auxiliary data types of the file
+-type zlevel()      :: 'none' | 'default' | 'best_compression' | 'best_speed' 
+                     | 0..9.
+-type zmethod()     :: 'deflated'.
+-type zwindowbits() :: -15..-9 | 9..47.
+-type zmemlevel()   :: 1..9.
+-type zstrategy()   :: 'default' | 'filtered' | 'huffman_only'.
+-type zflush()      :: 'none' | 'sync' | 'full' | 'finish'.
+
+%%------------------------------------------------------------------------
+
+%% open a z_stream
+-spec open() -> zstream().
+open() ->
+    open_port({spawn, "zlib_drv"}, [binary]).
+
+%% close and release z_stream
+-spec close(zstream()) -> 'ok'.
+close(Z) ->
+    try
+	true = port_close(Z),
+	receive	      %In case the caller is the owner and traps exits
+	    {'EXIT',Z,_} -> ok
+	after 0 -> ok
+	end
+    catch _:_ -> erlang:error(badarg)
+    end.
+
+-spec deflateInit(zstream()) -> 'ok'.
+deflateInit(Z) ->
+    call(Z, ?DEFLATE_INIT, <<?Z_DEFAULT_COMPRESSION:32>>).
+
+-spec deflateInit(zstream(), zlevel()) -> 'ok'.
+deflateInit(Z, Level) ->
+    call(Z, ?DEFLATE_INIT, <<(arg_level(Level)):32>>).
+
+-spec deflateInit(zstream(), zlevel(), zmethod(),
+		  zwindowbits(), zmemlevel(), zstrategy()) -> 'ok'.
+deflateInit(Z, Level, Method, WindowBits, MemLevel, Strategy) ->
+    call(Z, ?DEFLATE_INIT2, <<(arg_level(Level)):32, 
+			     (arg_method(Method)):32,
+			     (arg_bitsz(WindowBits)):32, 
+			     (arg_mem(MemLevel)):32,
+			     (arg_strategy(Strategy)):32>>).
+
+-spec deflateSetDictionary(zstream(), binary()) -> integer().
+deflateSetDictionary(Z, Dictionary) ->
+    call(Z, ?DEFLATE_SETDICT, Dictionary).
+
+-spec deflateReset(zstream()) -> 'ok'.
+deflateReset(Z) ->
+    call(Z, ?DEFLATE_RESET, []).
+
+-spec deflateParams(zstream(), zlevel(), zstrategy()) -> 'ok'.
+deflateParams(Z, Level, Strategy) ->
+    call(Z, ?DEFLATE_PARAMS, <<(arg_level(Level)):32, 
+			      (arg_strategy(Strategy)):32>>).
+
+-spec deflate(zstream(), iodata()) -> iolist().
+deflate(Z, Data) ->
+    deflate(Z, Data, none).
+
+-spec deflate(zstream(), iodata(), zflush()) -> iolist().
+deflate(Z, Data, Flush) ->
+    try port_command(Z, Data) of
+	true ->
+	    call(Z, ?DEFLATE, <<(arg_flush(Flush)):32>>),
+	    collect(Z)
+    catch 
+	error:_Err ->
+	    flush(Z),
+	    erlang:error(badarg) 
+    end.
+
+-spec deflateEnd(zstream()) -> 'ok'.
+deflateEnd(Z) ->
+    call(Z, ?DEFLATE_END, []).    
+
+-spec inflateInit(zstream()) -> 'ok'.
+inflateInit(Z) ->
+    call(Z, ?INFLATE_INIT, []).
+
+-spec inflateInit(zstream(), zwindowbits()) -> 'ok'.
+inflateInit(Z, WindowBits) -> 
+    call(Z, ?INFLATE_INIT2, <<(arg_bitsz(WindowBits)):32>>).
+
+-spec inflateSetDictionary(zstream(), binary()) -> 'ok'.
+inflateSetDictionary(Z, Dictionary) -> 
+    call(Z, ?INFLATE_SETDICT, Dictionary).
+
+-spec inflateSync(zstream()) -> 'ok'.
+inflateSync(Z) -> 
+    call(Z, ?INFLATE_SYNC, []).
+
+-spec inflateReset(zstream()) -> 'ok'.
+inflateReset(Z) -> 
+    call(Z, ?INFLATE_RESET, []).
+
+-spec inflate(zstream(), iodata()) -> iolist().
+inflate(Z, Data) ->
+    try port_command(Z, Data) of
+	true -> 
+	    call(Z, ?INFLATE, <<?Z_NO_FLUSH:32>>),
+	    collect(Z)
+    catch 
+	error:_Err ->
+	    flush(Z),
+	    erlang:error(badarg) 
+    end.
+
+-spec inflateEnd(zstream()) -> 'ok'.
+inflateEnd(Z) ->
+    call(Z, ?INFLATE_END, []).
+
+-spec setBufSize(zstream(), non_neg_integer()) -> 'ok'.
+setBufSize(Z, Size) ->
+    call(Z, ?SET_BUFSZ, <<Size:32>>).
+
+-spec getBufSize(zstream()) -> non_neg_integer().
+getBufSize(Z) ->
+    call(Z, ?GET_BUFSZ, []).
+
+-spec crc32(zstream()) -> integer().
+crc32(Z) ->
+    call(Z, ?CRC32_0, []).
+
+-spec crc32(zstream(), binary()) -> integer().
+crc32(Z, Binary) ->
+    call(Z, ?CRC32_1, Binary).
+
+-spec crc32(zstream(), integer(), binary()) -> integer().
+crc32(Z, CRC, Binary) when is_binary(Binary), is_integer(CRC) ->
+    call(Z, ?CRC32_2, <<CRC:32, Binary/binary>>);
+crc32(_Z, _CRC, _Binary)  ->
+    erlang:error(badarg).
+
+-spec adler32(zstream(), binary()) -> integer().
+adler32(Z, Binary) ->
+    call(Z, ?ADLER32_1, Binary).
+
+-spec adler32(zstream(), integer(), binary()) -> integer().
+adler32(Z, Adler, Binary) when is_binary(Binary), is_integer(Adler) ->
+    call(Z, ?ADLER32_2, <<Adler:32, Binary/binary>>);
+adler32(_Z, _Adler, _Binary)  ->
+    erlang:error(badarg).
+
+-spec crc32_combine(zstream(), integer(), integer(), integer()) -> integer().
+crc32_combine(Z, CRC1, CRC2, Len2) 
+  when is_integer(CRC1), is_integer(CRC2), is_integer(Len2) ->
+    call(Z, ?CRC32_COMBINE, <<CRC1:32, CRC2:32, Len2:32>>);
+crc32_combine(_Z, _CRC1, _CRC2, _Len2) ->
+    erlang:error(badarg).
+
+-spec adler32_combine(zstream(), integer(), integer(), integer()) -> integer().
+adler32_combine(Z, Adler1, Adler2, Len2) 
+  when is_integer(Adler1), is_integer(Adler2), is_integer(Len2) ->
+    call(Z, ?ADLER32_COMBINE, <<Adler1:32, Adler2:32, Len2:32>>);
+adler32_combine(_Z, _Adler1, _Adler2, _Len2) ->
+    erlang:error(badarg).
+
+-spec getQSize(zstream()) -> non_neg_integer().
+getQSize(Z) ->
+    call(Z, ?GET_QSIZE, []).
+
+%% compress/uncompress zlib with header
+-spec compress(binary()) -> binary().
+compress(Binary) ->
+    Z = open(),
+    deflateInit(Z, default),
+    Bs = deflate(Z, Binary,finish),
+    deflateEnd(Z),
+    close(Z),
+    list_to_binary(Bs).
+
+-spec uncompress(binary()) -> binary().
+uncompress(Binary) when byte_size(Binary) >= 8 ->
+    Z = open(),
+    inflateInit(Z),
+    Bs = inflate(Z, Binary),
+    inflateEnd(Z),
+    close(Z),
+    list_to_binary(Bs);
+uncompress(Binary) when is_binary(Binary) -> erlang:error(data_error);
+uncompress(_) -> erlang:error(badarg).
+
+%% unzip/zip zlib without header (zip members)
+-spec zip(binary()) -> binary().
+zip(Binary) ->
+    Z = open(),
+    deflateInit(Z, default, deflated, -?MAX_WBITS, 8, default),
+    Bs = deflate(Z, Binary, finish),
+    deflateEnd(Z),
+    close(Z),
+    list_to_binary(Bs).
+
+-spec unzip(binary()) -> binary().
+unzip(Binary) ->
+    Z = open(),
+    inflateInit(Z, -?MAX_WBITS),
+    Bs = inflate(Z, Binary),
+    inflateEnd(Z),
+    close(Z),
+    list_to_binary(Bs).
+    
+-spec gzip(iodata()) -> binary().
+gzip(Data) when is_binary(Data); is_list(Data) ->
+    Z = open(),
+    deflateInit(Z, default, deflated, 16+?MAX_WBITS, 8, default),
+    Bs = deflate(Z, Data, finish),
+    deflateEnd(Z),
+    close(Z),
+    iolist_to_binary(Bs);
+gzip(_) -> erlang:error(badarg).
+
+-spec gunzip(iodata()) -> binary().
+gunzip(Data) when is_binary(Data); is_list(Data) ->
+    Z = open(),
+    inflateInit(Z, 16+?MAX_WBITS),
+    Bs = inflate(Z, Data),
+    inflateEnd(Z),
+    close(Z),
+    iolist_to_binary(Bs);
+gunzip(_) -> erlang:error(badarg).
+
+-spec collect(zstream()) -> iolist().
+collect(Z) -> 
+    collect(Z, []).
+
+-spec collect(zstream(), iolist()) -> iolist().
+collect(Z, Acc) ->
+    receive 
+	{Z, {data, Bin}} ->
+	    collect(Z, [Bin|Acc])
+    after 0 ->
+	    reverse(Acc)
+    end.
+
+-spec flush(zstream()) -> 'ok'.
+flush(Z) ->
+    receive
+	{Z, {data,_}} ->
+	    flush(Z)
+    after 0 ->
+	    ok
+    end.
+    
+arg_flush(none)    -> ?Z_NO_FLUSH;
+%% ?Z_PARTIAL_FLUSH is deprecated in zlib -- deliberately not included.
+arg_flush(sync)    -> ?Z_SYNC_FLUSH;
+arg_flush(full)    -> ?Z_FULL_FLUSH;
+arg_flush(finish)  -> ?Z_FINISH;
+arg_flush(_) -> erlang:error(badarg).
+
+arg_level(none)             -> ?Z_NO_COMPRESSION;
+arg_level(best_speed)       -> ?Z_BEST_SPEED;
+arg_level(best_compression) -> ?Z_BEST_COMPRESSION;
+arg_level(default)          -> ?Z_DEFAULT_COMPRESSION;
+arg_level(Level) when is_integer(Level), Level >= 0, Level =< 9 -> Level;
+arg_level(_) -> erlang:error(badarg).
+     
+arg_strategy(filtered) ->     ?Z_FILTERED;
+arg_strategy(huffman_only) -> ?Z_HUFFMAN_ONLY;
+arg_strategy(default) ->      ?Z_DEFAULT_STRATEGY;
+arg_strategy(_) -> erlang:error(badarg).
+
+arg_method(deflated) -> ?Z_DEFLATED;
+arg_method(_) -> erlang:error(badarg).
+
+-spec arg_bitsz(zwindowbits()) -> zwindowbits().
+arg_bitsz(Bits) when is_integer(Bits) andalso
+		     ((8 < Bits andalso Bits < 48) orelse
+		      (-15 =< Bits andalso Bits < -8)) ->
+    Bits;
+arg_bitsz(_) -> erlang:error(badarg).
+
+-spec arg_mem(zmemlevel()) -> zmemlevel().
+arg_mem(Level) when is_integer(Level), 1 =< Level, Level =< 9 -> Level;
+arg_mem(_) -> erlang:error(badarg).
+
+call(Z, Cmd, Arg) ->
+    try port_control(Z, Cmd, Arg) of
+	[0|Res] -> list_to_atom(Res);
+	[1|Res] ->
+	    flush(Z),
+	    erlang:error(list_to_atom(Res));
+	[2,A,B,C,D] ->
+	    (A bsl 24)+(B bsl 16)+(C bsl 8)+D;
+	[3,A,B,C,D] ->
+	    erlang:error({need_dictionary,(A bsl 24)+(B bsl 16)+(C bsl 8)+D})
+    catch 
+	error:badarg -> %% Rethrow loses port_control from stacktrace.
+	    erlang:error(badarg)
+    end.
+
+reverse(X) ->
+    reverse(X, []).
+
+reverse([H|T], Y) ->
+    reverse(T, [H|Y]);
+reverse([], X) -> 
+    X.