.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Mail::SpamAssassin::Plugin::PDFInfo 3"
.TH Mail::SpamAssassin::Plugin::PDFInfo 3 "2015-04-29" "perl v5.16.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Mail::SpamAssassin::Plugin::PDFInfo \- PDFInfo Plugin for SpamAssassin
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  loadplugin     Mail::SpamAssassin::Plugin::PDFInfo
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This plugin helps detected spam using attached \s-1PDF\s0 files
.ie n .IP "See ""Usage:"" below \- more documentation see 20_pdfinfo.cf" 4
.el .IP "See ``Usage:'' below \- more documentation see 20_pdfinfo.cf" 4
.IX Item "See Usage: below - more documentation see 20_pdfinfo.cf"
.Vb 8
\& Original info kept for history.
\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\& PDFInfo Plugin for SpamAssassin
\& Version: 0.8
\& Info: $Id: PDFInfo.pm 904 2007\-08\-12 01:36:23Z root $
\& Created: 2007\-08\-10
\& Modified: 2007\-08\-10
\& By: Dallas Engelken
\&
\&
\& Changes:
\&   0.8 \- added .fdf detection (thanks John Lundin) [axb]
\&   0.7 \- fixed empty body/pdf count buglet(thanks Jeremy) [axb]
\&   0.6 \- added support for tags \- PDFCOUNT, PDFVERSION, PDFPRODUCER, etc.
\&       \- fixed issue on perl 5.6.1 where pdf_match_details() failed to call
\&         _find_pdf_mime_parts(), resulting in no detection of pdf mime parts.
\&       \- quoted\-printable support \- requires MIME::QuotedPrint (which should be in everyones
\&         install as a part of the MIME\-Base64 package which is a SA req)
\&       \- added simple pdf_is_empty_body() function with counts the body bytes minus the
\&         subject line.  can add optional <bytes> param if you need to allow for a few bytes.
\&   0.5 \- fix warns for undef $pdf_tags
\&       \- remove { } and \e before running eval in pdf_match_details to avoid eval error
\&   0.4 \- added pdf_is_encrypted() function
\&       \- added option to look for image HxW on same line
\&   0.3 \- added 2nd fuzzy md5 which uses pdf tag layout as data
\&       \- renamed pdf_image_named() to pdf_named()
\&          \- PDF images are encapsulated and have no names.  We are matching the PDF file name.
\&       \- renamed pdf_image_name_regex() to pdf_name_regex()
\&          \- PDF images are encapsulated and have no names.  We are matching the PDF file name.
\&       \- changed pdf_image_count() a bit and added pdf_count().
\&          \- pdf_count() checks how many pdf attachments there are on the mail
\&          \- pdf_image_count() checks how many images are found within all pdfs in the mail.
\&       \- removed the restriction of the pdf containing an image in order to md5 it.
\&       \- added pdf_match_details() function to check the following \*(Aqdetails\*(Aq
\&          \- author: Author of PDF if specified
\&          \- producer: Software used to produce PDF
\&          \- creator: Software used to produce PDF, usually similar to producer
\&          \- title: Title of PDF
\&          \- created: Creation Date
\&          \- modified: Last Modified
\&   0.2 \- support PDF octet\-stream
\&   0.1 \- just ported over the imageinfo code, and renamed to pdfinfo.
\&         \- removed all support for png, gif, and jpg from the code.
\&         \- prepended pdf_ to all function names to avoid conflicts with ImageInfo in SA 3.2.
\&
\&
\& Usage:
\&
\&  pdf_count()
\&
\&     body RULENAME  eval:pdf_count(<min>,[max])
\&        min: required, message contains at least x pdf mime parts
\&        max: optional, if specified, must not contain more than x pdf mime parts
\&
\&  pdf_image_count()
\&
\&     body RULENAME  eval:pdf_image_count(<min>,[max])
\&        min: required, message contains at least x images in pdf attachments.
\&        max: optional, if specified, must not contain more than x pdf images
\&
\&  pdf_pixel_coverage()
\&
\&     body RULENAME  eval:pdf_pixel_coverage(<min>,[max])
\&        min: required, message contains at least this much pixel area
\&        max: optional, if specified, message must not contain more than this much pixel area
\&
\&  pdf_named()
\&
\&     body RULENAME  eval:pdf_named(<string>)
\&        string: exact file name match, if you need partial match, see pdf_name_regex()
\&
\&  pdf_name_regex()
\&
\&     body RULENAME  eval:pdf_name_regex(<regex>)
\&        regex: regular expression, see examples in ruleset
\&
\&  pdf_match_md5()
\&
\&     body RULENAME  eval:pdf_match_md5(<string>)
\&        string: 32\-byte md5 hex
\&
\&  pdf_match_fuzzy_md5()
\&
\&     body RULENAME  eval:pdf_match_md5(<string>)
\&        string: 32\-byte md5 hex \- see ruleset for obtaining the fuzzy md5
\&
\&  pdf_match_details()
\&
\&     body RULENAME  eval:pdf_match_details(<detail>,<regex>);
\&        detail: author, creator, created, modified, producer, title
\&        regex: regular expression, see examples in ruleset
\&
\&  pdf_is_encrypted()
\&
\&     body RULENAME eval:pdf_is_encrypted()
\&
\&  pdf_is_empty_body()
\&
\&     body RULENAME eval:pdf_is_empty_body(<bytes>)
\&        bytes: maximum byte count to allow and still consider it empty
\&
\&  NOTE: See the ruleset for more examples that are not documented here.
.Ve