diff options
Diffstat (limited to 'src/couch/test/eunit/couch_file_tests.erl')
-rw-r--r-- | src/couch/test/eunit/couch_file_tests.erl | 533 |
1 files changed, 533 insertions, 0 deletions
diff --git a/src/couch/test/eunit/couch_file_tests.erl b/src/couch/test/eunit/couch_file_tests.erl new file mode 100644 index 000000000..e9806c09a --- /dev/null +++ b/src/couch/test/eunit/couch_file_tests.erl @@ -0,0 +1,533 @@ +% Licensed under the Apache License, Version 2.0 (the "License"); you may not +% use this file except in compliance with the License. You may obtain a copy of +% the License at +% +% http://www.apache.org/licenses/LICENSE-2.0 +% +% Unless required by applicable law or agreed to in writing, software +% distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +% WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +% License for the specific language governing permissions and limitations under +% the License. + +-module(couch_file_tests). + +-include_lib("couch/include/couch_eunit.hrl"). + +-define(BLOCK_SIZE, 4096). +-define(setup(F), {setup, fun setup/0, fun teardown/1, F}). +-define(foreach(Fs), {foreach, fun setup/0, fun teardown/1, Fs}). + + +setup() -> + {ok, Fd} = couch_file:open(?tempfile(), [create, overwrite]), + Fd. + +teardown(Fd) -> + case is_process_alive(Fd) of + true -> ok = couch_file:close(Fd); + false -> ok + end. + +open_close_test_() -> + { + "Test for proper file open and close", + { + setup, + fun() -> test_util:start(?MODULE, [ioq]) end, fun test_util:stop/1, + [ + should_return_enoent_if_missed(), + should_ignore_invalid_flags_with_open(), + ?setup(fun should_return_pid_on_file_open/1), + should_close_file_properly(), + ?setup(fun should_create_empty_new_files/1) + ] + } + }. + +should_return_enoent_if_missed() -> + ?_assertEqual({error, enoent}, couch_file:open("not a real file")). + +should_ignore_invalid_flags_with_open() -> + ?_assertMatch({ok, _}, + couch_file:open(?tempfile(), [create, invalid_option])). + +should_return_pid_on_file_open(Fd) -> + ?_assert(is_pid(Fd)). + +should_close_file_properly() -> + {ok, Fd} = couch_file:open(?tempfile(), [create, overwrite]), + ok = couch_file:close(Fd), + ?_assert(true). + +should_create_empty_new_files(Fd) -> + ?_assertMatch({ok, 0}, couch_file:bytes(Fd)). + + +read_write_test_() -> + { + "Common file read/write tests", + { + setup, + fun() -> test_util:start(?MODULE, [ioq]) end, fun test_util:stop/1, + ?foreach([ + fun should_increase_file_size_on_write/1, + fun should_return_current_file_size_on_write/1, + fun should_write_and_read_term/1, + fun should_write_and_read_binary/1, + fun should_write_and_read_large_binary/1, + fun should_return_term_as_binary_for_reading_binary/1, + fun should_read_term_written_as_binary/1, + fun should_read_iolist/1, + fun should_fsync/1, + fun should_not_read_beyond_eof/1, + fun should_truncate/1 + ]) + } + }. + + +should_increase_file_size_on_write(Fd) -> + {ok, 0, _} = couch_file:append_term(Fd, foo), + {ok, Size} = couch_file:bytes(Fd), + ?_assert(Size > 0). + +should_return_current_file_size_on_write(Fd) -> + {ok, 0, _} = couch_file:append_term(Fd, foo), + {ok, Size} = couch_file:bytes(Fd), + ?_assertMatch({ok, Size, _}, couch_file:append_term(Fd, bar)). + +should_write_and_read_term(Fd) -> + {ok, Pos, _} = couch_file:append_term(Fd, foo), + ?_assertMatch({ok, foo}, couch_file:pread_term(Fd, Pos)). + +should_write_and_read_binary(Fd) -> + {ok, Pos, _} = couch_file:append_binary(Fd, <<"fancy!">>), + ?_assertMatch({ok, <<"fancy!">>}, couch_file:pread_binary(Fd, Pos)). + +should_return_term_as_binary_for_reading_binary(Fd) -> + {ok, Pos, _} = couch_file:append_term(Fd, foo), + Foo = couch_compress:compress(foo, snappy), + ?_assertMatch({ok, Foo}, couch_file:pread_binary(Fd, Pos)). + +should_read_term_written_as_binary(Fd) -> + {ok, Pos, _} = couch_file:append_binary(Fd, <<131,100,0,3,102,111,111>>), + ?_assertMatch({ok, foo}, couch_file:pread_term(Fd, Pos)). + +should_write_and_read_large_binary(Fd) -> + BigBin = list_to_binary(lists:duplicate(100000, 0)), + {ok, Pos, _} = couch_file:append_binary(Fd, BigBin), + ?_assertMatch({ok, BigBin}, couch_file:pread_binary(Fd, Pos)). + +should_read_iolist(Fd) -> + %% append_binary == append_iolist? + %% Possible bug in pread_iolist or iolist() -> append_binary + {ok, Pos, _} = couch_file:append_binary(Fd, ["foo", $m, <<"bam">>]), + {ok, IoList} = couch_file:pread_iolist(Fd, Pos), + ?_assertMatch(<<"foombam">>, iolist_to_binary(IoList)). + +should_fsync(Fd) -> + {"How does on test fsync?", ?_assertMatch(ok, couch_file:sync(Fd))}. + +should_not_read_beyond_eof(Fd) -> + BigBin = list_to_binary(lists:duplicate(100000, 0)), + DoubleBin = round(byte_size(BigBin) * 2), + {ok, Pos, _Size} = couch_file:append_binary(Fd, BigBin), + {_, Filepath} = couch_file:process_info(Fd), + %% corrupt db file + {ok, Io} = file:open(Filepath, [read, write, binary]), + ok = file:pwrite(Io, Pos, <<0:1/integer, DoubleBin:31/integer>>), + file:close(Io), + unlink(Fd), + ExpectedError = {badmatch, {'EXIT', {bad_return_value, + {read_beyond_eof, Filepath}}}}, + ?_assertError(ExpectedError, couch_file:pread_binary(Fd, Pos)). + +should_truncate(Fd) -> + {ok, 0, _} = couch_file:append_term(Fd, foo), + {ok, Size} = couch_file:bytes(Fd), + BigBin = list_to_binary(lists:duplicate(100000, 0)), + {ok, _, _} = couch_file:append_binary(Fd, BigBin), + ok = couch_file:truncate(Fd, Size), + ?_assertMatch({ok, foo}, couch_file:pread_term(Fd, 0)). + +pread_limit_test_() -> + { + "Read limit tests", + { + setup, + fun() -> + Ctx = test_util:start(?MODULE), + config:set("couchdb", "max_pread_size", "50000"), + Ctx + end, + fun(Ctx) -> + config:delete("couchdb", "max_pread_size"), + test_util:stop(Ctx) + end, + ?foreach([ + fun should_increase_file_size_on_write/1, + fun should_return_current_file_size_on_write/1, + fun should_write_and_read_term/1, + fun should_write_and_read_binary/1, + fun should_not_read_more_than_pread_limit/1 + ]) + } + }. + +should_not_read_more_than_pread_limit(Fd) -> + {_, Filepath} = couch_file:process_info(Fd), + BigBin = list_to_binary(lists:duplicate(100000, 0)), + {ok, Pos, _Size} = couch_file:append_binary(Fd, BigBin), + unlink(Fd), + ExpectedError = {badmatch, {'EXIT', {bad_return_value, + {exceed_pread_limit, Filepath, 50000}}}}, + ?_assertError(ExpectedError, couch_file:pread_binary(Fd, Pos)). + + +header_test_() -> + { + "File header read/write tests", + { + setup, + fun() -> test_util:start(?MODULE, [ioq]) end, fun test_util:stop/1, + [ + ?foreach([ + fun should_write_and_read_atom_header/1, + fun should_write_and_read_tuple_header/1, + fun should_write_and_read_second_header/1, + fun should_truncate_second_header/1, + fun should_produce_same_file_size_on_rewrite/1, + fun should_save_headers_larger_than_block_size/1 + ]), + should_recover_header_marker_corruption(), + should_recover_header_size_corruption(), + should_recover_header_md5sig_corruption(), + should_recover_header_data_corruption() + ] + } + }. + + +should_write_and_read_atom_header(Fd) -> + ok = couch_file:write_header(Fd, hello), + ?_assertMatch({ok, hello}, couch_file:read_header(Fd)). + +should_write_and_read_tuple_header(Fd) -> + ok = couch_file:write_header(Fd, {<<"some_data">>, 32}), + ?_assertMatch({ok, {<<"some_data">>, 32}}, couch_file:read_header(Fd)). + +should_write_and_read_second_header(Fd) -> + ok = couch_file:write_header(Fd, {<<"some_data">>, 32}), + ok = couch_file:write_header(Fd, [foo, <<"more">>]), + ?_assertMatch({ok, [foo, <<"more">>]}, couch_file:read_header(Fd)). + +should_truncate_second_header(Fd) -> + ok = couch_file:write_header(Fd, {<<"some_data">>, 32}), + {ok, Size} = couch_file:bytes(Fd), + ok = couch_file:write_header(Fd, [foo, <<"more">>]), + ok = couch_file:truncate(Fd, Size), + ?_assertMatch({ok, {<<"some_data">>, 32}}, couch_file:read_header(Fd)). + +should_produce_same_file_size_on_rewrite(Fd) -> + ok = couch_file:write_header(Fd, {<<"some_data">>, 32}), + {ok, Size1} = couch_file:bytes(Fd), + ok = couch_file:write_header(Fd, [foo, <<"more">>]), + {ok, Size2} = couch_file:bytes(Fd), + ok = couch_file:truncate(Fd, Size1), + ok = couch_file:write_header(Fd, [foo, <<"more">>]), + ?_assertMatch({ok, Size2}, couch_file:bytes(Fd)). + +should_save_headers_larger_than_block_size(Fd) -> + Header = erlang:make_tuple(5000, <<"CouchDB">>), + couch_file:write_header(Fd, Header), + {"COUCHDB-1319", ?_assertMatch({ok, Header}, couch_file:read_header(Fd))}. + + +should_recover_header_marker_corruption() -> + ?_assertMatch( + ok, + check_header_recovery( + fun(CouchFd, RawFd, Expect, HeaderPos) -> + ?assertNotMatch(Expect, couch_file:read_header(CouchFd)), + file:pwrite(RawFd, HeaderPos, <<0>>), + ?assertMatch(Expect, couch_file:read_header(CouchFd)) + end) + ). + +should_recover_header_size_corruption() -> + ?_assertMatch( + ok, + check_header_recovery( + fun(CouchFd, RawFd, Expect, HeaderPos) -> + ?assertNotMatch(Expect, couch_file:read_header(CouchFd)), + % +1 for 0x1 byte marker + file:pwrite(RawFd, HeaderPos + 1, <<10/integer>>), + ?assertMatch(Expect, couch_file:read_header(CouchFd)) + end) + ). + +should_recover_header_md5sig_corruption() -> + ?_assertMatch( + ok, + check_header_recovery( + fun(CouchFd, RawFd, Expect, HeaderPos) -> + ?assertNotMatch(Expect, couch_file:read_header(CouchFd)), + % +5 = +1 for 0x1 byte and +4 for term size. + file:pwrite(RawFd, HeaderPos + 5, <<"F01034F88D320B22">>), + ?assertMatch(Expect, couch_file:read_header(CouchFd)) + end) + ). + +should_recover_header_data_corruption() -> + ?_assertMatch( + ok, + check_header_recovery( + fun(CouchFd, RawFd, Expect, HeaderPos) -> + ?assertNotMatch(Expect, couch_file:read_header(CouchFd)), + % +21 = +1 for 0x1 byte, +4 for term size and +16 for MD5 sig + file:pwrite(RawFd, HeaderPos + 21, <<"some data goes here!">>), + ?assertMatch(Expect, couch_file:read_header(CouchFd)) + end) + ). + + +check_header_recovery(CheckFun) -> + Path = ?tempfile(), + {ok, Fd} = couch_file:open(Path, [create, overwrite]), + {ok, RawFd} = file:open(Path, [read, write, raw, binary]), + + {ok, _} = write_random_data(Fd), + ExpectHeader = {some_atom, <<"a binary">>, 756}, + ok = couch_file:write_header(Fd, ExpectHeader), + + {ok, HeaderPos} = write_random_data(Fd), + ok = couch_file:write_header(Fd, {2342, <<"corruption! greed!">>}), + + CheckFun(Fd, RawFd, {ok, ExpectHeader}, HeaderPos), + + ok = file:close(RawFd), + ok = couch_file:close(Fd), + ok. + +write_random_data(Fd) -> + write_random_data(Fd, 100 + couch_rand:uniform(1000)). + +write_random_data(Fd, 0) -> + {ok, Bytes} = couch_file:bytes(Fd), + {ok, (1 + Bytes div ?BLOCK_SIZE) * ?BLOCK_SIZE}; +write_random_data(Fd, N) -> + Choices = [foo, bar, <<"bizzingle">>, "bank", ["rough", stuff]], + Term = lists:nth(couch_rand:uniform(4) + 1, Choices), + {ok, _, _} = couch_file:append_term(Fd, Term), + write_random_data(Fd, N - 1). + + +delete_test_() -> + { + "File delete tests", + { + foreach, + fun() -> + meck:new(config, [passthrough]), + File = ?tempfile() ++ ".couch", + RootDir = filename:dirname(File), + ok = couch_file:init_delete_dir(RootDir), + ok = file:write_file(File, <<>>), + {RootDir, File} + end, + fun({_, File}) -> + meck:unload(config), + file:delete(File) + end, + [ + fun(Cfg) -> + {"enable_database_recovery = false, context = delete", + make_enable_recovery_test_case(Cfg, false, delete)} + end, + fun(Cfg) -> + {"enable_database_recovery = true, context = delete", + make_enable_recovery_test_case(Cfg, true, delete)} + end, + fun(Cfg) -> + {"enable_database_recovery = false, context = compaction", + make_enable_recovery_test_case(Cfg, false, compaction)} + end, + fun(Cfg) -> + {"enable_database_recovery = true, context = compaction", + make_enable_recovery_test_case(Cfg, true, compaction)} + end, + fun(Cfg) -> + {"delete_after_rename = true", + make_delete_after_rename_test_case(Cfg, true)} + end, + fun(Cfg) -> + {"delete_after_rename = false", + make_delete_after_rename_test_case(Cfg, false)} + end + ] + } + }. + + +make_enable_recovery_test_case({RootDir, File}, EnableRecovery, Context) -> + meck:expect(config, get_boolean, fun + ("couchdb", "enable_database_recovery", _) -> EnableRecovery; + ("couchdb", "delete_after_rename", _) -> false + end), + FileExistsBefore = filelib:is_regular(File), + couch_file:delete(RootDir, File, [{context, Context}]), + FileExistsAfter = filelib:is_regular(File), + RenamedFiles = filelib:wildcard(filename:rootname(File) ++ "*.deleted.*"), + DeletedFiles = filelib:wildcard(RootDir ++ "/.delete/*"), + {ExpectRenamedCount, ExpectDeletedCount} = if + EnableRecovery andalso Context =:= delete -> {1, 0}; + true -> {0, 1} + end, + [ + ?_assert(FileExistsBefore), + ?_assertNot(FileExistsAfter), + ?_assertEqual(ExpectRenamedCount, length(RenamedFiles)), + ?_assertEqual(ExpectDeletedCount, length(DeletedFiles)) + ]. + +make_delete_after_rename_test_case({RootDir, File}, DeleteAfterRename) -> + meck:expect(config, get_boolean, fun + ("couchdb", "enable_database_recovery", _) -> false; + ("couchdb", "delete_after_rename", _) -> DeleteAfterRename + end), + FileExistsBefore = filelib:is_regular(File), + couch_file:delete(RootDir, File), + FileExistsAfter = filelib:is_regular(File), + RenamedFiles = filelib:wildcard(filename:join([RootDir, ".delete", "*"])), + ExpectRenamedCount = if DeleteAfterRename -> 0; true -> 1 end, + [ + ?_assert(FileExistsBefore), + ?_assertNot(FileExistsAfter), + ?_assertEqual(ExpectRenamedCount, length(RenamedFiles)) + ]. + + +nuke_dir_test_() -> + { + "Nuke directory tests", + { + foreach, + fun() -> + meck:new(config, [passthrough]), + File0 = ?tempfile() ++ ".couch", + RootDir = filename:dirname(File0), + BaseName = filename:basename(File0), + Seed = couch_rand:uniform(8999999999) + 999999999, + DDocDir = io_lib:format("db.~b_design", [Seed]), + ViewDir = filename:join([RootDir, DDocDir]), + file:make_dir(ViewDir), + File = filename:join([ViewDir, BaseName]), + file:rename(File0, File), + ok = couch_file:init_delete_dir(RootDir), + ok = file:write_file(File, <<>>), + {RootDir, ViewDir} + end, + fun({RootDir, ViewDir}) -> + meck:unload(config), + remove_dir(ViewDir), + Ext = filename:extension(ViewDir), + case filelib:wildcard(RootDir ++ "/*.deleted" ++ Ext) of + [DelDir] -> remove_dir(DelDir); + _ -> ok + end + end, + [ + fun(Cfg) -> + {"enable_database_recovery = false", + make_rename_dir_test_case(Cfg, false)} + end, + fun(Cfg) -> + {"enable_database_recovery = true", + make_rename_dir_test_case(Cfg, true)} + end, + fun(Cfg) -> + {"delete_after_rename = true", + make_delete_dir_test_case(Cfg, true)} + end, + fun(Cfg) -> + {"delete_after_rename = false", + make_delete_dir_test_case(Cfg, false)} + end + ] + } + }. + + +make_rename_dir_test_case({RootDir, ViewDir}, EnableRecovery) -> + meck:expect(config, get_boolean, fun + ("couchdb", "enable_database_recovery", _) -> EnableRecovery; + ("couchdb", "delete_after_rename", _) -> true + end), + DirExistsBefore = filelib:is_dir(ViewDir), + couch_file:nuke_dir(RootDir, ViewDir), + DirExistsAfter = filelib:is_dir(ViewDir), + Ext = filename:extension(ViewDir), + RenamedDirs = filelib:wildcard(RootDir ++ "/*.deleted" ++ Ext), + ExpectRenamedCount = if EnableRecovery -> 1; true -> 0 end, + [ + ?_assert(DirExistsBefore), + ?_assertNot(DirExistsAfter), + ?_assertEqual(ExpectRenamedCount, length(RenamedDirs)) + ]. + +make_delete_dir_test_case({RootDir, ViewDir}, DeleteAfterRename) -> + meck:expect(config, get_boolean, fun + ("couchdb", "enable_database_recovery", _) -> false; + ("couchdb", "delete_after_rename", _) -> DeleteAfterRename + end), + DirExistsBefore = filelib:is_dir(ViewDir), + couch_file:nuke_dir(RootDir, ViewDir), + DirExistsAfter = filelib:is_dir(ViewDir), + Ext = filename:extension(ViewDir), + RenamedDirs = filelib:wildcard(RootDir ++ "/*.deleted" ++ Ext), + RenamedFiles = filelib:wildcard(RootDir ++ "/.delete/*"), + ExpectRenamedCount = if DeleteAfterRename -> 0; true -> 1 end, + [ + ?_assert(DirExistsBefore), + ?_assertNot(DirExistsAfter), + ?_assertEqual(0, length(RenamedDirs)), + ?_assertEqual(ExpectRenamedCount, length(RenamedFiles)) + ]. + +remove_dir(Dir) -> + [file:delete(File) || File <- filelib:wildcard(filename:join([Dir, "*"]))], + file:del_dir(Dir). + + +fsync_error_test_() -> + { + "Test fsync raises errors", + { + setup, + fun() -> + test_util:start(?MODULE, [ioq]) + end, + fun(Ctx) -> + test_util:stop(Ctx) + end, + [ + fun fsync_raises_errors/0 + ] + } + }. + + +fsync_raises_errors() -> + Fd = spawn(fun() -> fake_fsync_fd() end), + ?assertError({fsync_error, eio}, couch_file:sync(Fd)). + + +fake_fsync_fd() -> + % Mocking gen_server did not go very + % well so faking the couch_file pid + % will have to do. + receive + {'$gen_call', From, sync} -> + gen:reply(From, {error, eio}) + end. |