-#!/usr/bin/ruby -wKU
+#!/usr/bin/ruby -wU
#
# mailshears, to prune unused mail directories.
#
-# Mail accounts for virtual hosts are stored in SQL, and managed by
-# Postfixadmin. However, the physical directories are handled by
-# Postfix/Dovecot and are left untouched by Postfixadmin. This is good
-# for security, but comes at a cost: Postfixadmin can't remove a
-# user's mail directory when his or her account is deleted.
-#
-# This program compares the list of filesystem accounts with the ones
-# in the database. It outputs any accounts that exist in the
-# filesystem, but not the database.
-#
-
-# We need Pathname to get the real filesystem path
-# of this script (and not, for example, the path of
-# a symlink which points to it).
-require 'pathname'
-
-# This bit of magic adds the parent directory (the
-# project root) to the list of ruby load paths.
-# Thus, our require statements will work regardless of
-# how or from where the script was run.
-executable = Pathname.new(__FILE__).realpath.to_s
-$: << File.dirname(executable) + '/../'
-
-# Needed for rm_rf.
-require 'fileutils'
-
-# Load our config file.
-require 'bin/configuration'
-
-# And the necessary classes.
-require 'src/errors.rb'
-require 'src/exit_codes.rb'
-require 'src/dovecot_mailstore'
-require 'src/postfixadmin_db'
-dms = DovecotMailstore.new(Configuration::MAIL_ROOT)
+# Define a usage string using the program name.
+exe = File.basename($PROGRAM_NAME)
+usage = "#{exe} [prune | rm <target> | mv <src> <dst>]"
-pgadb = PostfixadminDb.new(Configuration::DBHOST,
- Configuration::DBPORT,
- Configuration::DBOPTS,
- Configuration::DBTTY,
- Configuration::DBNAME,
- Configuration::DBUSER,
- Configuration::DBPASS)
+# Defaults
+mode_name = 'prune'
+mode = :prune
-
-# First, we find out if any domains have been removed from the
-# database but not from the filesystem.
-begin
- # Get the list of domains according to the filesystem.
- fs_domains = dms.get_domains_from_filesystem()
-rescue StandardError => e
- puts "There was an error retrieving domains from the filesystem: #{e.to_s}"
- Kernel.exit(ExitCodes::FILESYSTEM_ERROR)
+# Now, if a mode was supplied, it should be in ARGV[0].
+if ARGV.length() > 0
+ mode_names = ['prune', 'rm', 'mv']
+ if mode_names.include?(ARGV.first().downcase()) then
+ # Peel the mode name off the head of the list.
+ mode_name = ARGV.shift()
+ end
end
-begin
- # ...and according to the Postfixadmin database.
- db_domains = pgadb.get_domains_from_db()
-rescue DatabaseError => e
- puts "There was an error connecting to the database: #{e.to_s}"
- Kernel.exit(ExitCodes::DATABASE_ERROR)
+if mode_name == 'rm' then
+ mode = :rm
+elsif mode_name == 'mv' then
+ mode = :mv
end
-
-# Then, we get the list of accounts that have been removed. We did
-# the domains first so that, if a domain was removed, we can avoid
-# reporting each of its accounts individually.
-begin
- # Get the list of accounts according to the filesystem.
- fs_accts = dms.get_accounts_from_filesystem(db_domains)
-rescue StandardError => e
- puts "There was an error retrieving accounts from the filesystem: #{e.to_s}"
- Kernel.exit(ExitCodes::FILESYSTEM_ERROR)
-end
-
-begin
- # ...and according to the Postfixadmin database.
- db_accts = pgadb.get_accounts_from_db()
-rescue DatabaseError => e
- puts "There was an error connecting to the database: #{e.to_s}"
- Kernel.exit(ExitCodes::DATABASE_ERROR)
+# Need this before referencing ExitCodes.
+require 'mailshears'
+
+# Since we removed both the executable name and the mode name (if it
+# existed) from ARGV, what remains should be the required
+# arguments.
+if (mode == :prune and (ARGV.length() != 0)) or
+ (mode == :rm and (ARGV.length() < 1)) or
+ (mode == :mv and (ARGV.length() != 2)) then
+ puts "ERROR: missing (or extra) command-line arguments."
+ puts "Usage: #{usage}"
+ Kernel.exit(ExitCodes::BAD_COMMAND_LINE)
end
+cfg = Configuration.new()
-# The list of domains on the filesystem that aren't in the DB.
-dom_difference = fs_domains - db_domains
+# Load each of the plugins that we'll need.
+cfg.plugins.each do |plugin_file|
+ require "#{mode_name}/plugins/#{plugin_file}"
+end
-# And accounts on the filesystem that aren't in the DB and don't
-# belong to a domain that was removed.
-acct_difference = fs_accts - db_accts
+# And the runners.
+require "#{mode_name}/#{mode_name}_runner"
+require "#{mode_name}/#{mode_name}_dummy_runner"
-# Don't output any unnecessary junk. Cron might mail it to someone.
-if dom_difference.size > 0 or acct_difference.size > 0
- # The header that we output before the list of accounts.
- # Just the path of this script, and the current time.
- header = "#{$0}, "
+def make_header(plugin_name)
+ # The header that we output before the list of domains/users.
+ # Just the path of this script, the current time, and the plugin name.
+ exe = File.basename($PROGRAM_NAME)
+ header = "#{exe}, "
current_time = Time.now()
if current_time.respond_to?(:iso8601)
header += current_time.to_s
end
- puts header
- puts '-' * header.size # Underline the header.
+ header += ' (Plugin: ' + plugin_name + ")\n"
+ header += '-' * header.size # Underline the header.
- dom_difference.each do |domain|
- puts "Found: #{domain} (#{dms.get_domain_path(domain)})"
- end
+ return header
+end
- acct_difference.each do |account|
- puts "Found: #{account} (#{dms.get_account_path(account)})"
- end
- if Configuration::I_MEAN_BUSINESS
- dom_difference.each do |domain|
- domain_path = dms.get_domain_path(domain)
- FileUtils.rm_rf(domain_path)
- puts "Removed: #{domain_path}"
- end
-
- acct_difference.each do |account|
- account_path = dms.get_account_path(account)
- FileUtils.rm_rf(account_path)
- puts "Removed: #{account_path}"
- end
- end
+plugin_module = nil
- puts ""
+if mode == :rm then
+ plugin_module = RmPlugin
+elsif mode == :mv then
+ plugin_module = MvPlugin
+else
+ # Safe, catch-all default
+ plugin_module = PrunePlugin
+end
+
+
+# Buffer the output so that we can avoid printing the informational
+# header when no plugins produce output.
+require 'stringio'
+output_buffer = StringIO.new()
+$stdout = output_buffer
+
+begin
+ plugin_module.run(cfg, *ARGV)
+ensure
+ # Now restore stdout, and print the header plus whatever the plugins
+ # produced if they produced anything. If they didn't produce any
+ # output, then we avoid printing the header.
+ #
+ # This gets wrapped in an "ensure" block because otherwise, if
+ # plugin_module.run() crashes, the traceback will get stored in
+ # output_buffer and never get printed.
+ $stdout = STDOUT
+ if output_buffer.size > 0 then
+ puts make_header(plugin_module.to_s())
+ puts output_buffer.string()
+ end
end