CLAWS-MAIL-CLAMD-PLUGIN(7)

📦
version 4.4.0 · 6 versions
, in ubuntu stonking

💖 claws-mail-clamd-plugin — bestie edition 💖

okay so this is the manual page for claws-mail-clamd-plugin, straight out of the Claws Mail section of your friendly neighbourhood man pages, and I am so obsessed with telling you about it. 🦋

✨ NAME ✨

claws-mail-clamd-plugin — scan mails for virus with ClamAV 🦠💅

🫶 DESCRIPTION 🫶

So this manual page documents the claws-mail-clamd-plugin package briefly, bestie. Just a lil overview, not a whole dissertation.

Real talk: this manual page was written for the Debian™ distribution because the original program literally does not have a manual page. Not one. Not me being dramatic, that's just the situation. 😭

claws-mail-clamd-plugin is a plugin (aka a loadable module) for the Claw Mail mailer.

What does it do? It lets you scan your mails with Clam AntiVirus. Iconic behaviour honestly. 👑

But here's the tea: due to license restrictions, no clamav library is used at all. So instead, it is required that the ClamAV daemon (clamd) is running on some computer — either localhost or a remote one, dealer's choice. The mails to be scanned, and the scanning results coming back, get sent to and received from this daemon using a socket. That's the whole relationship. 🫶

Now, this may impose additional requirements for your home folder and your Claws Mail resource folder (~/.claws-mail): if clamd is configured to use a Unix socket, then global executable permission must be given to these folders. Yeah. I know. We'll get to that.

To avoid changing permissions, clamd can be configured to use a TCP socket instead — but heads up, that requires enabling manual configuration in claws-mail-clamd-plugin. Trade-offs, babes. 🤷‍♀️

🌸 USAGE 🌸

Before you can use a plugin, you must instruct Claws Mail to, like, actually load it on startup. It's not gonna read your mind.

Here's the whole vibe:

  1. Go to the “Configuration” menu on the main window toolbar.
  2. Open the “Plugins...” dialog.
  3. Click the “Load plugin...” button.
  4. Select the plugin file, named clamd.so.
  5. Press the “Open” button.

And that's it. Slay. ✨

🔥 SECURITY CONSIDERATIONS 🔥

okay bestie sit down for a sec, this part is important. 💀

Giving global executable permissions to your home folder and your ~/.claws-mail folder means other users of the system can browse the content of these folders. Read that again. Everyone on that machine. 👀

This may not be what you want — especially on shared machines. So like, think about it before you go chmod-ing your whole life away. 🫣

🎀 SEE ALSO 🎀

👑 AUTHORS 👑

  • Michael Rasmussen <mir@datanom.net> — wrote the claws-mail-clamd-plugin plugin. 🛠️
  • Ricardo Mones <mones@debian.org> — wrote this manpage for the Debian™ system. 📝

Copyright © 2007-2020 Ricardo Mones

This manual page was written for the Debian system (but may be used by others). Sharing is caring fr fr. 🫶

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

and that's the whole page, bestie! 🌈 this version lives at source 4.4.0-1build1, dated 2026-08-21, and honestly? she ate. 💅✨🦋

📦 where this page comes from