net.dns: Ensure all pending requests get notified of a timeout when looking up a...
[prosody.git] / util / datamanager.lua
index 30cd082bdf31eb5232542c19034caf44eb37f97f..4a4d62b3c098519f361912162f9a73e30209c960 100644 (file)
@@ -1,33 +1,53 @@
 -- Prosody IM
--- Copyright (C) 2008-2009 Matthew Wild
--- Copyright (C) 2008-2009 Waqas Hussain
--- 
+-- Copyright (C) 2008-2010 Matthew Wild
+-- Copyright (C) 2008-2010 Waqas Hussain
+--
 -- This project is MIT/X11 licensed. Please see the
 -- COPYING file in the source package for more information.
 --
 
 
 local format = string.format;
-local setmetatable, type = setmetatable, type;
-local pairs, ipairs = pairs, ipairs;
+local setmetatable = setmetatable;
+local ipairs = ipairs;
 local char = string.char;
-local loadfile, setfenv, pcall = loadfile, setfenv, pcall;
+local pcall = pcall;
 local log = require "util.logger".init("datamanager");
 local io_open = io.open;
 local os_remove = os.remove;
-local tostring, tonumber = tostring, tonumber;
-local error = error;
+local os_rename = os.rename;
+local tonumber = tonumber;
 local next = next;
 local t_insert = table.insert;
-local append = require "util.serialization".append;
-local path_separator = "/"; if os.getenv("WINDIR") then path_separator = "\\" end
-local lfs_mkdir = require "lfs".mkdir;
+local t_concat = table.concat;
+local envloadfile = require"util.envload".envloadfile;
+local serialize = require "util.serialization".serialize;
+local path_separator = assert ( package.config:match ( "^([^\n]+)" ) , "package.config not in standard form" ) -- Extract directory seperator from package.config (an undocumented string that comes with lua)
+local lfs = require "lfs";
+local prosody = prosody;
+
+local raw_mkdir = lfs.mkdir;
+local function fallocate(f, offset, len)
+       -- This assumes that current position == offset
+       local fake_data = (" "):rep(len);
+       local ok, msg = f:write(fake_data);
+       if not ok then
+               return ok, msg;
+       end
+       f:seek("set", offset);
+       return true;
+end;
+pcall(function()
+       local pposix = require "util.pposix";
+       raw_mkdir = pposix.mkdir or raw_mkdir; -- Doesn't trample on umask
+       fallocate = pposix.fallocate or fallocate;
+end);
 
 module "datamanager"
 
 ---- utils -----
 local encode, decode;
-do 
+do
        local urlcodes = setmetatable({}, { __index = function (t, k) t[k] = char(tonumber("0x"..k)); return t[k]; end });
 
        decode = function (s)
@@ -43,13 +63,13 @@ local _mkdir = {};
 local function mkdir(path)
        path = path:gsub("/", path_separator); -- TODO as an optimization, do this during path creation rather than here
        if not _mkdir[path] then
-               lfs_mkdir(path);
+               raw_mkdir(path);
                _mkdir[path] = true;
        end
        return path;
 end
 
-local data_path = "data";
+local data_path = (prosody and prosody.paths and prosody.paths.data) or ".";
 local callbacks = {};
 
 ------- API -------------
@@ -64,7 +84,7 @@ local function callback(username, host, datastore, data)
                username, host, datastore, data = f(username, host, datastore, data);
                if username == false then break; end
        end
-       
+
        return username, host, datastore, data;
 end
 function add_callback(func)
@@ -93,30 +113,68 @@ function getpath(username, host, datastore, ext, create)
        if username then
                if create then mkdir(mkdir(mkdir(data_path).."/"..host).."/"..datastore); end
                return format("%s/%s/%s/%s.%s", data_path, host, datastore, username, ext);
-       elseif host then
+       else
                if create then mkdir(mkdir(data_path).."/"..host); end
                return format("%s/%s/%s.%s", data_path, host, datastore, ext);
-       else
-               if create then mkdir(data_path); end
-               return format("%s/%s.%s", data_path, datastore, ext);
        end
 end
 
 function load(username, host, datastore)
-       local data, ret = loadfile(getpath(username, host, datastore));
+       local data, ret = envloadfile(getpath(username, host, datastore), {});
        if not data then
-               log("debug", "Failed to load "..datastore.." storage ('"..ret.."') for user: "..(username or "nil").."@"..(host or "nil"));
-               return nil;
+               local mode = lfs.attributes(getpath(username, host, datastore), "mode");
+               if not mode then
+                       log("debug", "Assuming empty %s storage ('%s') for user: %s@%s", datastore, ret, username or "nil", host or "nil");
+                       return nil;
+               else -- file exists, but can't be read
+                       -- TODO more detailed error checking and logging?
+                       log("error", "Failed to load %s storage ('%s') for user: %s@%s", datastore, ret, username or "nil", host or "nil");
+                       return nil, "Error reading storage";
+               end
        end
-       setfenv(data, {});
+
        local success, ret = pcall(data);
        if not success then
-               log("error", "Unable to load "..datastore.." storage ('"..ret.."') for user: "..(username or "nil").."@"..(host or "nil"));
-               return nil;
+               log("error", "Unable to load %s storage ('%s') for user: %s@%s", datastore, ret, username or "nil", host or "nil");
+               return nil, "Error reading storage";
        end
        return ret;
 end
 
+local function atomic_store(filename, data)
+       local scratch = filename.."~";
+       local f, ok, msg;
+       repeat
+               f, msg = io_open(scratch, "w");
+               if not f then break end
+
+               ok, msg = f:write(data);
+               if not ok then break end
+
+               ok, msg = f:close();
+               if not ok then break end
+
+               return os_rename(scratch, filename);
+       until false;
+
+       -- Cleanup
+       if f then f:close(); end
+       os_remove(scratch);
+       return nil, msg;
+end
+
+if prosody.platform ~= "posix" then
+       -- os.rename does not overwrite existing files on Windows
+       -- TODO We could use Transactional NTFS on Vista and above
+       function atomic_store(filename, data)
+               local f, err = io_open(filename, "w");
+               if not f then return f, err; end
+               local ok, msg = f:write(data);
+               if not ok then f:close(); return ok, msg; end
+               return f:close();
+       end
+end
+
 function store(username, host, datastore, data)
        if not data then
                data = {};
@@ -128,20 +186,26 @@ function store(username, host, datastore, data)
        end
 
        -- save the datastore
-       local f, msg = io_open(getpath(username, host, datastore, nil, true), "w+");
-       if not f then
-               log("error", "Unable to write to "..datastore.." storage ('"..msg.."') for user: "..(username or "nil").."@"..(host or "nil"));
-               return;
-       end
-       f:write("return ");
-       append(f, data);
-       f:close();
-       if next(data) == nil then -- try to delete empty datastore
-               log("debug", "Removing empty %s datastore for user %s@%s", datastore, username or "nil", host or "nil");
-               os_remove(getpath(username, host, datastore));
-       end
-       -- we write data even when we are deleting because lua doesn't have a
-       -- platform independent way of checking for non-exisitng files
+       local d = "return " .. serialize(data) .. ";\n";
+       local mkdir_cache_cleared;
+       repeat
+               local ok, msg = atomic_store(getpath(username, host, datastore, nil, true), d);
+               if not ok then
+                       if not mkdir_cache_cleared then -- We may need to recreate a removed directory
+                               _mkdir = {};
+                               mkdir_cache_cleared = true;
+                       else
+                               log("error", "Unable to write to %s storage ('%s') for user: %s@%s", datastore, msg, username or "nil", host or "nil");
+                               return nil, "Error saving to storage";
+                       end
+               end
+               if next(data) == nil then -- try to delete empty datastore
+                       log("debug", "Removing empty %s datastore for user %s@%s", datastore, username or "nil", host or "nil");
+                       os_remove(getpath(username, host, datastore));
+               end
+               -- we write data even when we are deleting because lua doesn't have a
+               -- platform independent way of checking for non-exisitng files
+       until ok;
        return true;
 end
 
@@ -149,14 +213,24 @@ function list_append(username, host, datastore, data)
        if not data then return; end
        if callback(username, host, datastore) == false then return true; end
        -- save the datastore
-       local f, msg = io_open(getpath(username, host, datastore, "list", true), "a+");
+       local f, msg = io_open(getpath(username, host, datastore, "list", true), "r+");
+       if not f then
+               f, msg = io_open(getpath(username, host, datastore, "list", true), "w");
+       end
        if not f then
-               log("error", "Unable to write to "..datastore.." storage ('"..msg.."') for user: "..(username or "nil").."@"..(host or "nil"));
+               log("error", "Unable to write to %s storage ('%s') for user: %s@%s", datastore, msg, username or "nil", host or "nil");
                return;
        end
-       f:write("item(");
-       append(f, data);
-       f:write(");\n");
+       local data = "item(" ..  serialize(data) .. ");\n";
+       local pos = f:seek("end");
+       local ok, msg = fallocate(f, pos, #data);
+       f:seek("set", pos);
+       if ok then
+               f:write(data);
+       else
+               log("error", "Unable to write to %s storage ('%s') for user: %s@%s", datastore, msg, username or "nil", host or "nil");
+               return ok, msg;
+       end
        f:close();
        return true;
 end
@@ -167,17 +241,15 @@ function list_store(username, host, datastore, data)
        end
        if callback(username, host, datastore) == false then return true; end
        -- save the datastore
-       local f, msg = io_open(getpath(username, host, datastore, "list", true), "w+");
-       if not f then
-               log("error", "Unable to write to "..datastore.." storage ('"..msg.."') for user: "..(username or "nil").."@"..(host or "nil"));
-               return;
+       local d = {};
+       for _, item in ipairs(data) do
+               d[#d+1] = "item(" .. serialize(item) .. ");\n";
        end
-       for _, d in ipairs(data) do
-               f:write("item(");
-               append(f, d);
-               f:write(");\n");
+       local ok, msg = atomic_store(getpath(username, host, datastore, "list", true), t_concat(d));
+       if not ok then
+               log("error", "Unable to write to %s storage ('%s') for user: %s@%s", datastore, msg, username or "nil", host or "nil");
+               return;
        end
-       f:close();
        if next(data) == nil then -- try to delete empty datastore
                log("debug", "Removing empty %s datastore for user %s@%s", datastore, username or "nil", host or "nil");
                os_remove(getpath(username, host, datastore, "list"));
@@ -188,19 +260,108 @@ function list_store(username, host, datastore, data)
 end
 
 function list_load(username, host, datastore)
-       local data, ret = loadfile(getpath(username, host, datastore, "list"));
+       local items = {};
+       local data, ret = envloadfile(getpath(username, host, datastore, "list"), {item = function(i) t_insert(items, i); end});
        if not data then
-               log("debug", "Failed to load "..datastore.." storage ('"..ret.."') for user: "..(username or "nil").."@"..(host or "nil"));
-               return nil;
+               local mode = lfs.attributes(getpath(username, host, datastore, "list"), "mode");
+               if not mode then
+                       log("debug", "Assuming empty %s storage ('%s') for user: %s@%s", datastore, ret, username or "nil", host or "nil");
+                       return nil;
+               else -- file exists, but can't be read
+                       -- TODO more detailed error checking and logging?
+                       log("error", "Failed to load %s storage ('%s') for user: %s@%s", datastore, ret, username or "nil", host or "nil");
+                       return nil, "Error reading storage";
+               end
        end
-       local items = {};
-       setfenv(data, {item = function(i) t_insert(items, i); end});
+
        local success, ret = pcall(data);
        if not success then
-               log("error", "Unable to load "..datastore.." storage ('"..ret.."') for user: "..(username or "nil").."@"..(host or "nil"));
-               return nil;
+               log("error", "Unable to load %s storage ('%s') for user: %s@%s", datastore, ret, username or "nil", host or "nil");
+               return nil, "Error reading storage";
        end
        return items;
 end
 
+local type_map = {
+       keyval = "dat";
+       list = "list";
+}
+
+function users(host, store, typ)
+       typ = type_map[typ or "keyval"];
+       local store_dir = format("%s/%s/%s", data_path, encode(host), store);
+
+       local mode, err = lfs.attributes(store_dir, "mode");
+       if not mode then
+               return function() log("debug", err or (store_dir .. " does not exist")) end
+       end
+       local next, state = lfs.dir(store_dir);
+       return function(state)
+               for node in next, state do
+                       local file, ext = node:match("^(.*)%.([dalist]+)$");
+                       if file and ext == typ then
+                               return decode(file);
+                       end
+               end
+       end, state;
+end
+
+function stores(username, host, typ)
+       typ = type_map[typ or "keyval"];
+       local store_dir = format("%s/%s/", data_path, encode(host));
+
+       local mode, err = lfs.attributes(store_dir, "mode");
+       if not mode then
+               return function() log("debug", err or (store_dir .. " does not exist")) end
+       end
+       local next, state = lfs.dir(store_dir);
+       return function(state)
+               for node in next, state do
+                       if not node:match"^%." then
+                               if username == true then
+                                       if lfs.attributes(store_dir..node, "mode") == "directory" then
+                                               return decode(node);
+                                       end
+                               elseif username then
+                                       local store = decode(node)
+                                       if lfs.attributes(getpath(username, host, store, typ), "mode") then
+                                               return store;
+                                       end
+                               elseif lfs.attributes(node, "mode") == "file" then
+                                       local file, ext = node:match("^(.*)%.([dalist]+)$");
+                                       if ext == typ then
+                                               return decode(file)
+                                       end
+                               end
+                       end
+               end
+       end, state;
+end
+
+local function do_remove(path)
+       local ok, err = os_remove(path);
+       if not ok and lfs.attributes(path, "mode") then
+               return ok, err;
+       end
+       return true
+end
+
+function purge(username, host)
+       local host_dir = format("%s/%s/", data_path, encode(host));
+       local errs = {};
+       for file in lfs.dir(host_dir) do
+               if lfs.attributes(host_dir..file, "mode") == "directory" then
+                       local store = decode(file);
+                       local ok, err = do_remove(getpath(username, host, store));
+                       if not ok then errs[#errs+1] = err; end
+
+                       local ok, err = do_remove(getpath(username, host, store, "list"));
+                       if not ok then errs[#errs+1] = err; end
+               end
+       end
+       return #errs == 0, t_concat(errs, ", ");
+end
+
+_M.path_decode = decode;
+_M.path_encode = encode;
 return _M;