sisimai 5.0.3-java → 5.1.0-java

data/lib/sisimai/lhost/dragonfly.rb

@@ -0,0 +1,114 @@
+module Sisimai::Lhost
+  # Sisimai::Lhost::DragonFly decodes a bounce email which created by DMA: DragonFly Mail Agent
+  # https://www.dragonflybsd.org/handbook/mta/.
+  # Methods in the module are called from only Sisimai::Message.
+  module DragonFly
+    class << self
+      require 'sisimai/lhost'
+      require 'sisimai/address'
+      require 'sisimai/smtp/command'
+
+      Indicators = Sisimai::Lhost.INDICATORS
+      Boundaries = ['Original message follows.', 'Message headers follow'].freeze
+      StartingOf = {
+        # https://github.com/corecode/dma/blob/ffad280aa40c242aa9a2cb9ca5b1b6e8efedd17e/mail.c#L84
+        message: ['This is the DragonFly Mail Agent '],
+      }.freeze
+      MessagesOf = {
+        'expired' => [
+          # https://github.com/corecode/dma/blob/master/dma.c#L370C1-L374C19
+          # dma.c:370| if (gettimeofday(&now, NULL) == 0 &&
+          # dma.c:371|     (now.tv_sec - st.st_mtim.tv_sec > MAX_TIMEOUT)) {
+          # dma.c:372|     snprintf(errmsg, sizeof(errmsg),
+          # dma.c:373|          "Could not deliver for the last %d seconds. Giving up.",
+          # dma.c:374|          MAX_TIMEOUT);
+          # dma.c:375|     goto bounce;
+          # dma.c:376| }
+          'Could not deliver for the last ',
+        ],
+        'hostunknown' => [
+          # net.c:663| snprintf(errmsg, sizeof(errmsg), "DNS lookup failure: host %s not found", host);
+          'DNS lookup failure: host ',
+        ],
+      }.freeze
+
+      # @abstract Decodes the bounce message from DMA: DragonFly Mail Agent
+      # @param  [Hash] mhead    Message headers of a bounce email
+      # @param  [String] mbody  Message body of a bounce email
+      # @return [Hash]          Bounce data list and message/rfc822 part
+      # @return [Nil]           it failed to decode or the arguments are missing
+      def inquire(mhead, mbody)
+        return nil unless mhead['subject'].start_with?('Mail delivery failed')
+        return nil unless mhead['received'].any? { |a| a.include?(' (DragonFly Mail Agent') }
+
+        dscontents = [Sisimai::Lhost.DELIVERYSTATUS]
+        emailparts = Sisimai::RFC5322.part(mbody, Boundaries)
+        bodyslices = emailparts[0].split("\n")
+        readcursor = 0      # (Integer) Points the current cursor position
+        recipients = 0      # (Integer) The number of 'Final-Recipient' header
+        v = nil
+
+        while e = bodyslices.shift do
+          # Read error messages and delivery status lines from the head of the email to the previous
+          # line of the beginning of the original message.
+          if readcursor == 0
+            # Beginning of the bounce message or delivery status part
+            readcursor |= Indicators[:deliverystatus] if e.start_with?(StartingOf[:message][0])
+            next
+          end
+          next if (readcursor & Indicators[:deliverystatus]) == 0
+          next if e.empty?
+
+          # This is the DragonFly Mail Agent v0.13 at df.example.jp.
+          #
+          # There was an error delivering your mail to <kijitora@example.com>.
+          #
+          # email.example.jp [192.0.2.25] did not like our RCPT TO:
+          # 552 5.2.2 <kijitora@example.com>: Recipient address rejected: Mailbox full
+          #
+          # Original message follows.
+          v = dscontents[-1]
+
+          if e.start_with?('There was an error delivering your mail to <')
+            # email.example.jp [192.0.2.25] did not like our RCPT TO:
+            # 552 5.2.2 <kijitora@example.com>: Recipient address rejected: Mailbox full
+            if v['recipient']
+              # There are multiple recipient addresses in the message body.
+              dscontents << Sisimai::Lhost.DELIVERYSTATUS
+              v = dscontents[-1]
+            end
+            v['recipient'] = Sisimai::Address.find(e, false)[0][:address]
+            recipients += 1
+          else
+            # Pick the error message
+            v['diagnosis'] ||= ''
+            v['diagnosis'] << ' ' << e
+
+            # Pick the remote hostname, and the SMTP command
+            # net.c:500| snprintf(errmsg, sizeof(errmsg), "%s [%s] did not like our %s:\n%s",
+            next unless e.include?(' did not like our ')
+            next if v['rhost']
+
+            p = e.split(' ', 3)
+            v['rhost']   = if p[0].include?('.') then p[0] else p[1] end
+            v['command'] = Sisimai::SMTP::Command.find(e) || ''
+          end
+        end
+        return nil unless recipients > 0
+
+        dscontents.each do |e|
+          e['diagnosis'] = Sisimai::String.sweep(e['diagnosis'])
+          MessagesOf.each_key do |r|
+            # Verify each regular expression of session errors
+            next unless MessagesOf[r].any? { |a| e['diagnosis'].include?(a) }
+            e['reason'] = r
+            break
+          end
+        end
+        return { 'ds' => dscontents, 'rfc822' => emailparts[1] }
+      end
+      def description; return 'DragonFly'; end
+    end
+  end
+end
+

data/lib/sisimai/lhost/einsundeins.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::EinsUndEins parses a bounce email which created by 1&1. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::EinsUndEins decodes a bounce email which created by 1&1 https://www.1und1.de/.
+  # Methods in the module are called from only Sisimai::Message.
   module EinsUndEins
     class << self
       require 'sisimai/lhost'
@@ -13,11 +13,11 @@ module Sisimai::Lhost
       }.freeze
       MessagesOf = { 'mesgtoobig' => ['Mail size limit exceeded'] }.freeze
 
-      # Parse bounce messages from 1&1
+      # @abstract Decode the bounce message from 1&1
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['from'].start_with?('"Mail Delivery System"')
         return nil unless mhead['subject'] == 'Mail delivery failed: returning message to sender'

data/lib/sisimai/lhost/exchange2003.rb

@@ -1,5 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Exchange2003 parses a bounce email which created by Microsoft Exchange Server 2003.
+  # Sisimai::Lhost::Exchange2003 decodes a bounce email which created by Microsoft Exchange Server
+  # 2003 https://www.microsoft.com/microsoft-365/exchange/email.
   # Methods in the module are called from only Sisimai::Message.
   module Exchange2003
     class << self
@@ -39,11 +40,11 @@ module Sisimai::Lhost
         ],
       }.freeze
 
-      # Parse bounce messages from Microsoft Exchange Server 2003
+      # @abstract Decodes the bounce message from Microsoft Exchange Server 2003
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         match = 0
         tryto = []

data/lib/sisimai/lhost/exchange2007.rb

@@ -1,5 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Exchange2007 parses a bounce email which created by Microsoft Exchange Server 2007.
+  # Sisimai::Lhost::Exchange2007 decodes a bounce email which created by Microsoft Exchange Server
+  # 2007 https://www.microsoft.com/microsoft-365/exchange/email.
   # Methods in the module are called from only Sisimai::Message.
   module Exchange2007
     class << self
@@ -39,11 +40,11 @@ module Sisimai::Lhost
         'QUEUE.Expired'                  => 'expired',       # 550 4.4.7 QUEUE.Expired
       }.freeze
 
-      # Parse bounce messages from Microsoft Exchange Server 2007
+      # @abstract Decodes the bounce message from Microsoft Exchange Server 2007
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # Content-Language: en-US, fr-FR
         match   = nil

data/lib/sisimai/lhost/exim.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Exim parses a bounce email which created by Exim. Methods in the module are called
-  # from only Sisimai::Message.
+  # Sisimai::Lhost::Exim decodes a bounce email which created by Exim Internet Mailer https://www.exim.org/.
+  # Methods in the module are called from only Sisimai::Message.
   module Exim
     class << self
       require 'sisimai/lhost'
@@ -117,11 +117,11 @@ module Sisimai::Lhost
         'was frozen on arrival by ',
       ].freeze
 
-      # Parse bounce messages from Exim
+      # @abstract Decodes the bounce message from Exim
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil if mhead['from'].include?('.mail.ru')
 

data/lib/sisimai/lhost/ezweb.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::EZweb parses a bounce email which created by au EZweb. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::EZweb decodes a bounce email which created by au EZweb https://www.au.com/mobile/.
+  # Methods in the module are called from only Sisimai::Message.
   module EZweb
     class << self
       require 'sisimai/lhost'
@@ -25,11 +25,11 @@ module Sisimai::Lhost
         'onhold' => ['Each of the following recipients was rejected by a remote mail server'],
       }.freeze
 
-      # Parse bounce messages from au EZweb
+      # @abstract Decodes the bounce message from au EZweb
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         match  = 0
         match += 1 if mhead['from'].include?('Postmaster@ezweb.ne.jp')

data/lib/sisimai/lhost/facebook.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Facebook parses a bounce email which created by Facebook. Methods in the module
-  # are called from only Sisimai::Message.
+  # Sisimai::Lhost::Facebook decodes a bounce email which created by Facebook https://www.facebook.com.
+  # Methods in the module are called from only Sisimai::Message.
   module Facebook
     class << self
       require 'sisimai/lhost'
@@ -68,11 +68,11 @@ module Sisimai::Lhost
         ],
       }.freeze
 
-      # Parse bounce messages from Facebook
+      # @abstract Decodes the bounce message from Facebook
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['from'] == 'Facebook <mailer-daemon@mx.facebook.com>'
         return nil unless mhead['subject'] == 'Sorry, your message could not be delivered'

data/lib/sisimai/lhost/fml.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::FML parses a bounce email which created by fml. Methods in the module are called
-  # from only Sisimai::Message.
+  # Sisimai::Lhost::FML decodes a bounce email which created by fml mailing list server/manager
+  # https://www.fml.org/. Methods in the module are called from only Sisimai::Message.
   module FML
     class << self
       require 'sisimai/lhost'
@@ -38,11 +38,11 @@ module Sisimai::Lhost
         'securityerror' => ['Security alert:'],
       }.freeze
 
-      # Parse bounce messages from fml mailling list server/manager
+      # @abstract Decodes the bounce message from fml mailling list server/manager
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       # @since v4.22.3
       def inquire(mhead, mbody)
         return nil unless mhead['x-mlserver']

data/lib/sisimai/lhost/gmail.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Gmail parses a bounce email which created by Gmail. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::Gmail decodes a bounce email which created by Gmail https://mail.google.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module Gmail
     class << self
       require 'sisimai/lhost'
@@ -96,11 +96,11 @@ module Sisimai::Lhost
         '18' => { 'command' => 'DATA', 'reason' => 'filtered' },
       }.freeze
 
-      # Parse bounce messages from Gmail
+      # @abstract Decodes the bounce message from Gmail
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # From: Mail Delivery Subsystem <mailer-daemon@googlemail.com>
         # Received: from vw-in-f109.1e100.net [74.125.113.109] by ...

data/lib/sisimai/lhost/gmx.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::GMX parses a bounce email which created by GMX. Methods in the module are called
-  # from only Sisimai::Message.
+  # Sisimai::Lhost::GMX decodes a bounce email which created by GMX https://gmx.net/.
+  # Methods in the module are called from only Sisimai::Message.
   module GMX
     class << self
       require 'sisimai/lhost'
@@ -10,11 +10,11 @@ module Sisimai::Lhost
       StartingOf = { message: ['This message was created automatically by mail delivery software'] }.freeze
       MessagesOf = { 'expired' => ['delivery retry timeout exceeded'] }.freeze
 
-      # Parse bounce messages from GMX
+      # @abstract Decodes the bounce message from GMX
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # Envelope-To: <kijitora@mail.example.com>
         # X-GMX-Antispam: 0 (Mail was not recognized as spam); Detail=V3;

data/lib/sisimai/lhost/googlegroups.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::GoogleGroups parses a bounce email which created by Google Groups. Methods in the
-  # module are called from only Sisimai::Message.
+  # Sisimai::Lhost::GoogleGroups decodes a bounce email which created by Google Groups https://groups.google.com.
+  # Methods in the module are called from only Sisimai::Message.
   module GoogleGroups
     class << self
       require 'sisimai/lhost'
@@ -8,11 +8,11 @@ module Sisimai::Lhost
       Indicators = Sisimai::Lhost.INDICATORS
       Boundaries = ['----- Original message -----'].freeze
 
-      # Parse bounce messages from Google Groups
+      # @abstract Decodes the bounce message from Google Groups
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       # @since v4.25.6
       def inquire(mhead, mbody)
         return nil unless mhead['from'].end_with?('<mailer-daemon@googlemail.com>')

data/lib/sisimai/lhost/gsuite.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::GSuite parses a bounce email which created by G Suite. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::GSuite decodes a bounce email which created by Google Workspace https://workspace.google.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module GSuite
     class << self
       require 'sisimai/lhost'
@@ -17,11 +17,11 @@ module Sisimai::Lhost
         'networkerror' => [' had no relevant answers.', ' responded with code NXDOMAIN'],
       }.freeze
 
-      # Parse bounce messages from G Suite (Transfer from G Suite to a destinaion host)
+      # @abstract Decodes the bounce message from G Suite (Transfer from G Suite to a destinaion host)
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['from'].end_with?('<mailer-daemon@googlemail.com>')
         return nil unless mhead['subject'].start_with?('Delivery Status Notification')

data/lib/sisimai/lhost/imailserver.rb

@@ -1,5 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::IMailServer parses a bounce email which created by Ipswitch IMail Server.
+  # Sisimai::Lhost::IMailServer decodes a bounce email which created by Progress iMail Server
+  # https://community.progress.com/s/products/imailserver.
   # Methods in the module are called from only Sisimai::Message.
   module IMailServer
     class << self
@@ -16,11 +17,11 @@ module Sisimai::Lhost
         'expired'       => ['Delivery failed '],
       }.freeze
 
-      # Parse bounce messages from IMailServer
+      # @abstract Decodes the bounce message from Progress iMail Server
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # X-Mailer: <SMTP32 v8.22>
         match  = 0

data/lib/sisimai/lhost/interscanmss.rb

@@ -1,16 +1,17 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::InterScanMSS parses a bounce email which created by Trend Micro InterScan Messaging
-  # Security Suite. Methods in the module are called from only Sisimai::Message.
+  # Sisimai::Lhost::InterScanMSS decodes a bounce email which created by Trend Micro InterScan
+  # Messaging Security Suite https://www.trendmicro.com/en_us/business/products/user-protection/sps/email-and-collaboration/interscan-messaging.html.
+  # Methods in the module are called from only Sisimai::Message.
   module InterScanMSS
     class << self
       require 'sisimai/lhost'
       Boundaries = ['Content-Type: message/rfc822'].freeze
 
-      # Parse bounce messages from InterScanMSS
+        # @abstract Decodes the bounce message from Trend Micro InterScanMSS Messaging Secutiry Suie
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # :received => %r/[ ][(]InterScanMSS[)][ ]with[ ]/,
         match = 0

data/lib/sisimai/lhost/kddi.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::KDDI parses a bounce email which created by au by KDDI. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::KDDI decodes a bounce email which created by au by KDDI https://www.au.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module KDDI
     class << self
       require 'sisimai/lhost'
@@ -14,11 +14,11 @@ module Sisimai::Lhost
         'hostunknown' => ['As the remote domain doesnt exist'],
       }.freeze
 
-      # Parse bounce messages from au by KDDI
+      # @abstract Decodes the bounce message from au by KDDI
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # :'message-id' => %r/[@].+[.]ezweb[.]ne[.]jp[>]\z/,
         match  = 0

data/lib/sisimai/lhost/mailfoundry.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::MailFoundry parses a bounce email which created by MailFoundry. Methods in the
-  # module are called from only Sisimai::Message.
+  # Sisimai::Lhost::MailFoundry decodes a bounce email which created by MailFoundry https://www.barracuda.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module MailFoundry
     class << self
       require 'sisimai/lhost'
@@ -12,11 +12,11 @@ module Sisimai::Lhost
         error:   ['Delivery failed for the following reason:'],
       }.freeze
 
-      # Parse bounce messages from MailFoundry
+      # @abstract Decodes the bounce message from MailFoundry
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['subject'] == 'Message delivery has failed'
         return nil unless mhead['received'].any? { |a| a.include?('(MAILFOUNDRY) id ') }

data/lib/sisimai/lhost/mailmarshalsmtp.rb

@@ -1,6 +1,7 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::MailMarshalSMTP parses a bounce email which created by Trustwave Secure Email
-  # Gateway: formerly MailMarshal SMTP. Methods in the module are called from only Sisimai::Message.
+  # Sisimai::Lhost::MailMarshalSMTP decodes a bounce email which created by Trustwave Secure Email
+  # Gateway: formerly MailMarshal SMTP https://www.trustwave.com/en-us/services/email-security/.
+  # Methods in the module are called from only Sisimai::Message.
   module MailMarshalSMTP
     class << self
       require 'sisimai/lhost'
@@ -13,11 +14,11 @@ module Sisimai::Lhost
         rcpts:   ['The following recipients were affected:'],
       }.freeze
 
-      # Parse bounce messages from MailMarshalSMTP
+      # @abstract Decodes the bounce message from Trustwave Secure Email Gateway (Formerly MailMarshalSMTP)
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['subject'].start_with?('Undeliverable Mail: "')
 

data/lib/sisimai/lhost/mailru.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::MailRu parses a bounce email which created by @mail.ru. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::MailRu decodes a bounce email which created by @mail.ru https://mail.ru/.
+  # Methods in the module are called from only Sisimai::Message.
   module MailRu
     class << self
       # Based on Sisimai::Lhost::Exim
@@ -44,11 +44,11 @@ module Sisimai::Lhost
         'contenterror' => ['Too many "Received" headers'],
       }.freeze
 
-      # Parse bounce messages from @mail.ru
+      # @abstract Decodes the bounce message from @mail.ru
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         mfrom  = mhead['from'].downcase
         msgid  = mhead['message-id'] ? mhead['message-id'].downcase : ''

data/lib/sisimai/lhost/mcafee.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::McAfee parses a bounce email which created by McAfee Email Appliance. Methods in
-  # the module are called from only Sisimai::Message.
+  # Sisimai::Lhost::McAfee decodes a bounce email which created by McAfee Email Appliance.
+  # Methods in the module are called from only Sisimai::Message.
   module McAfee
     class << self
       require 'sisimai/lhost'
@@ -10,11 +10,11 @@ module Sisimai::Lhost
       StartingOf = { message: ['--- The following addresses had delivery problems ---'] }.freeze
       MessagesOf = { 'userunknown' => [' User not exist', ' unknown.', '550 Unknown user ', 'No such user'] }.freeze
 
-      # Parse bounce messages from McAfee Email Appliance
+      # @abstract Decodes the bounce message from McAfee Email Appliance
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # X-NAI-Header: Modified by McAfee Email and Web Security Virtual Appliance
         return nil unless mhead['x-nai-header']

data/lib/sisimai/lhost/messagelabs.rb

@@ -1,5 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::MessageLabs parses a bounce email which created by Symantec.cloud: formerly MessageLabs.
+  # Sisimai::Lhost::MessageLabs decodes a bounce email which created by Email Security (formerly MessageLab)
+  # https://www.broadcom.com/products/cybersecurity/emails.
   # Methods in the module are called from only Sisimai::Message.
   module MessageLabs
     class << self
@@ -13,11 +14,11 @@ module Sisimai::Lhost
         'securityerror' => ['Please turn on SMTP Authentication in your mail client'],
       }.freeze
 
-      # Parse bounce messages from Symantec.cloud(MessageLabs)
+      # @abstract Decodes the bounce message from Email Security (formerly Symantec.cloud (formerly MessageLabs))
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # X-Msg-Ref: server-11.tower-143.messagelabs.com!1419367175!36473369!1
         # X-Originating-IP: [10.245.230.38]

data/lib/sisimai/lhost/messagingserver.rb

@@ -1,6 +1,7 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::MessagingServer parses a bounce email which created by Oracle Communications Messaging
-  # Server and Sun Java System Messaging Server. Methods in the module are called from only Sisimai::Message.
+  # Sisimai::Lhost::MessagingServer decodes a bounce email which created by Oracle Communications
+  # Messaging Server and Sun Java System Messaging Server https://docs.oracle.com/en/industries/communications/messaging-server/index.html.
+  # Methods in the module are called from only Sisimai::Message.
   module MessagingServer
     class << self
       require 'sisimai/lhost'
@@ -10,11 +11,11 @@ module Sisimai::Lhost
       StartingOf = { message: ['This report relates to a message you sent with the following header fields:'] }.freeze
       MessagesOf = { 'hostunknown' => ['Illegal host/domain name found'] }.freeze
 
-      # Parse bounce messages from MessagingServer
+      # @abstract Decodes the bounce message from MessagingServer
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         match  = 0
         match += 1 if mhead['content-type'].include?('Boundary_(ID_')

data/lib/sisimai/lhost/mfilter.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::mFILTER parses a bounce email which created by Digital Arts m-FILTER. Methods in
-  # the module are called from only Sisimai::Message.
+  # Sisimai::Lhost::mFILTER decodes a bounce email which created by Digital Arts m-FILTER https://www.daj.jp/bs/mf/.
+  # Methods in the module are called from only Sisimai::Message.
   module MFILTER
     class << self
       require 'sisimai/lhost'
@@ -12,11 +12,11 @@ module Sisimai::Lhost
         command: ['-------SMTP command'],
       }.freeze
 
-      # Parse bounce messages from Digital Arts m-FILTER
+      # @abstract Decodes the bounce message from Digital Arts m-FILTER
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # X-Mailer: m-FILTER
         return nil unless mhead['x-mailer'].to_s == 'm-FILTER'

data/lib/sisimai/lhost/mxlogic.rb

@@ -1,5 +1,5 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::MXLogic parses a bounce email which created by McAfee SaaS (formerly MX Logic).
+  # Sisimai::Lhost::MXLogic decodes a bounce email which created by McAfee SaaS (formerly MXLogic).
   # Methods in the module are called from only Sisimai::Message.
   module MXLogic
     class << self
@@ -67,11 +67,11 @@ module Sisimai::Lhost
         'was frozen on arrival by ',
       ].freeze
 
-      # Parse bounce messages from MXLogic
+      # @abstract Decodes the bounce message from McAfee Saas (Formerly MXLogic)
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # X-MX-Bounce: mta/src/queue/bounce
         # X-MXL-NoteHash: ffffffffffffffff-0000000000000000000000000000000000000000