Settings file

16 June 2010

All the settings of Pinjo revealer are stored in the file Pinjo.ini. This file is located in the directory where Pinjo revealer is installed.

Most settings from the ini-file are configurable via the userinterface. The ini-file consists of 11 sections: Settings, Heurastic, Viruscheck, Debug, BlackLists, AllowedHosts, FromAddresses, ManualBlacklist, LocalDomains, LocalIp and Forward.

Settings
Heurastic
VirusCheck
Debug
BlackLists
AllowedHosts
FromAddresses
ManualBlacklist
LocalDomains
LocalIp
Forward

Values marked in red can only be configured directly in the settingsfile.

[Settings]

The settings section has all values for the server and client connection.

ListenIP
Contains the IP number where Pinjo is listening to. If empty Pinjo will be listening to all available IP numbers on the system.
ListenPort
Contains the port number where Pinjo is listening to. Default port 25 will be used.
OutgoingIP
Contains the IP number of your original mailserver. Pinjo will forward all mail to that mailserver.
OutgoingPort
Contains the port number where Pinjo will connect to. Default port 26 will be used.
DnsIP
The Ip number of the DNS Pinjo will use for blacklist lookups.
ServerTimeout
This is the timeout value of the server in case of no activity. Default this timeout will be 600 seconds or 10 minutes.
NewSubject
This is the new subject of your mailmessages in case of spam. Default it is ‘Pinjo says: “#SUBJECT#” is spam’ where #SUBJECT# will be replaced with the original subject of the mailmessage
ModifySubject
Setting to determine whether Pinjo should pass through spammail or reject it. Default value is 1 (meaning TRUE).
RelayLocalOnly
Setting to determine whether Pinjo should relay local domains only. Default value is 1 (meaning TRUE).
RelayLocalOnlyIP
Setting to determine whether Pinjo should relay local IP numbers only. Default value is 1 (meaning TRUE).
MaxConnections
Setting to limit the number of simultanious incoming connections. Default value is unlimited.
ClearCountersOnRotate
Setting to clear the counters when rotating the logfiles. Since counters can increase to a large number this might be useful. Note that this setting only applies to the counters on the statistics window. Default value is 0 (meaning FALSE).
DNSTimeout
Setting to change the timeout value of the blacklist servers. You might want to increase this if the number of Timeout values is large in the statistics window. Default value is 5 (seconds).
MultipleMailForwarding
Setting to enable or disable the use of mail forwarding to multiple underlying mailservers. In this case you only need 1 version of Pinjo for multiple underlying mailservers. Default value is 0 (meaning not used: all mail will be forwarded to the default mailserver).
Forward
Specifies that spammail should be forwarded to an other emailaddress as stated in MailForwardAddress. The original user mailbox will remain clean from the specified messages.
MailForwardAddress
Specifies the address where mail should be forwarded to in case it’s mareked as spam. This setting is only valid in when the Forward setting is enabled. The use of the variables #USER# and #DOMAIN# make it possible to forward spam to a new mailbox for each user.
Eg. when using spam#USER#@#DOMAIN# as value, all spammail for user demo@example.com will be forwarded to spamdemo@example.com.
CopyMsgIfWhiteListed
Indicates that a messages should be copied to the autolearn folder for automatic learning of the system. This value is valid for messages explicitly specified on the ‘Whitelisting’ tab.
CopyMsgIfBlackListed
Indicates that a messages should be copied to the autolearn folder for automatic learning of the system. This value is valid for messages explicitly specified on the ‘Blacklisting’ tab.
MailHostName
Defines the hostname used in the Received header lines of messages.
Welcome
Defines the system welcome line of Pinjo. Available only in the registered version.
SaveStatistics
If enabled will save the statistics in the right column of the ‘Statistics’ tab.
AllowEmptyMailFrom
If set to 0 (default = 1) empty mail from: messages will be rejected. These messages are often used for non-delivery notifications.

[Heurastic]

DoHeurastic
Setting to determine whether Pinjo should do heurastic email scanning. Default is 0 (meaning FALSE)
ModifySubject
Setting to determine whether Pinjo should change the subject when suspected spam. Default value is 1.
NewSubject
This is the new subject of your mailmessages in case of suspected heurastic spam. Default it is ‘Pinjo suspects: “#SUBJECT#” is spam’ where #SUBJECT# will be replaced with the original subject of the mailmessage.
Forward
Specifies that spammail should be forwarded to an other emailaddress as stated in MailForwardAddress. The original user mailbox will remain clean from the specified messages.
MailForwardAddress
Specifies the address where mail should be forwarded to in case it’s mareked as spam. This setting is only valid in when the Forward setting is enabled. The use of the variables #USER# and #DOMAIN# make it possible to forward spam to a new mailbox for each user.
Threshold
Specifies at which score mail should be marked as spam. Default mail will be marked as spam when the score is 5 or above.
MaxMailSize
Setting to prevent checking of large messages, which will probably not be spam after all. Default setting is 30 (KB). Mail messages larger as this value will not be checked.
HeurasticCheckTimeout
The maximum time a heurastic check should take. This is a built in precaution in case the external heurastic program stops responding. Pinjo will automatically terminate the process after the specified time. Time is specified in ms. default is 300000 which is 300 seconds.
DropAtScore
Specifies to drop the message if the score exceeds the value in setting DropScore
DropScore
Specifies the score threshold at which a mailmessage should be dropped instead of forwarded. Used in combination with DropAtScore
AutoLearnAtRotate
Specifies whether autolearning should be initiated at midnight after logfile rotation. Default is 1 (meaning TRUE)
DeleteFilesAfterLearn
Specifies whether Pinjo should delete the files after the learning process. Default is 1 (meaning TRUE)
Multidomainprefix
Only to be used in case the ‘Heurastic rulesets per domain’ feature is used. The Multidomainprefix value can be filled to modify the default ./config directory where the rulesets are defined.

[VirusCheck]

DoVirusCheck
Setting to determine whether Pinjo should check for virusses in email messages. Default is 0 (meaning FALSE)
VirusProgram
Specifies the commandline and parameters that should be executed to viruscheck a mail message. the variable %s should be used to specify the temporary mail message, and will be filled by Pinjo.
VirusCheckTimeout
The maximum time a virus check should take. This is a built in precaution in case the external viruscheck program stops responding. Pinjo will automatically terminite the process after the specified time. Time is specified in ms. default is 30000 which is 30 seconds.
ResultCode
This setting should contain the return errorlevel of the virus check program when a virus is detected.

[Debug]

Acceptance
Setting to log all connects, disconnects, blacklist queries and relay statistics. Default is 0 (meaning FALSE)
SMTPServer
Setting to log all communication between the SMTP server and Pinjo. This logging can be very verbose. Default is 0 (meaning FALSE)
SMTPClient
Setting to log all communication between Pinjo and your mailserver. This logging can be very verbose. Default is 0 (meaning FALSE)
LogScreen
Logging to the statusscreen will be activated by this setting. Default is 0 (meaning FALSE)
LogFileRotation
If enabled logfile rotation will take place. Default is 0 (meaning FALSE)
LogFileWindowSize
Value of the logfile rotatation window. Logfiles will be saved during the number of days entered here. Default is 7 days.