|
Commands for Quarantine Management |
|
You can manage Quarantine with the following commands: •quarantine-search [range:START/NUMBER] [sort:SORT_TYPE] [sender:EMAIL_SUBSTR] [rcpt:EMAIL_SUBSTR]* [period:DATE1[/DATE2]] [size:SIZE] [subject:'SUBJECT_SUBSTR'] [id:id-like] [order:ascent|descent] - searches messages in Quarantine by the specified criteria. Messages are output starting with START (numeration begins with 0), and in the quantity of NUMBER elements. If START and NUMBER are not specified, all found messages satisfying other criteria are output. If the NUMBER value is set to 0, all elements are output. The following parameters are used: oSORT_TYPE - type of the sorting. Possible values: •date (by default) - sort by date of moving messages to Quarantine; •size - sort by message size; •sender - sort by sender address; •subject - sort by message subject. oEMAIL_SUBSTR - substring for search in the rcpt or sender fields. operiod - period for which messages are output. If not specified, messages are output for the whole period. oDATE1 - output messages moved to Quarantine after the specified time (inclusive). oDATE2 - upper time line of moving the message to Quarantine (inclusively). The DATE format corresponds to the ISO format - YYYYMMDDTHHMMSS, where T - separator between time and date. The time is set and output as local time on a host where Dr.Web MailD is operating. oSIZE - maximum size (in bytes). Returns only messages with the size exceeding the specified value. When the value is set to 0, the size is unlimited. oSUBJECT_SUBSTR - substring enclosed in quotation marks in the original subject of the message (that is, before the message was modified by the product components). If the substring does not contain spaces, the enclosing quotation marks can be omitted. If quotation marks are present in the name, the ' character must be doubled. oorder - order in which results are returned (ascent - ascending, descent - descending). Default value: descent. If there is a mistake in a parameter, the quarantine-search command cannot be executed. If several recipient templates are specified, only messages that contain all templates are output (similar to the effect of AND logical operator). For all parameters, except rcpt, the value specified last in the command line is used. For rcpt, the number of recipients increases with every new input value. Output format: N. id SENDER RCTPS where: oN - ordinal number of the found message; oSENDER - sender of the message from the envelope; oRCPTS - recipients of the message from the envelope; oSUBJECT - subject of the message (output in UTF8 encryption); oSIZE - size of the message, in bytes; oDATE - date of moving the message to Quarantine; oBLOCK_OBJECTN - object blocking the message. Examples: # quarantine-search Returns the list of all messages in Quarantine, starting from the newest. # quarantine-search range:45/15 id:def/drweb/% Returns 15 newest messages in Quarantine, missing first 45 messages for the Drweb plug-in. # quarantine-search rcpt:john@smith.com Returns all messages with john@smith.com recipient in Quarantine, starting from the newest. # quarantine-search sort:size sender: period:20090101T100001/20090102T100000 size:5242880 id:def/vaderetro/% Outputs the messages in descending order, received for Vaderetro plug-in on January 1, 2009 from 10 a.m. to 10 a.m. of the next day, and size of which exceeds 5 MB. Output example: # quarantine-search •quarantine-count [range:START/NUMBER] [sort:SORT_TYPE] [sender:EMAIL_SUBSTR] [rcpt:EMAIL_SUBSTR]* [period:DATE1[/DATE2]] [size:SIZE] [subject:'SUBJECT_SUBSTR'] [id:id-like] [order:ascent|descent] - similar to the quarantine-search command, but, instead of the messages, total number of found messages is output. Output examples: # quarantine-count •quarantine-remove id-like [part-of-email1, part-of-email2, ..] - removes the specified recipients (searched as a substring) part-of-email1, part-of-email2, ... from the envelopes of the messages, identifiers of which match id-like (all specified recipients must be present in the envelope). If a message has no recipients left or the list for their removal is not specified, the whole message is removed from Quarantine. Examples: # quarantine-remove %/backup/% drweb.com> All messages sent to addresses ending in drweb.com are deleted from Quarantine and backup. # quarantine-remove % <foo@dwreb.com> <foo2@dwreb.com> All messages sent to both foo@dwreb.com and foo2@dwreb.com addresses are deleted from Quarantine and backup. •quarantine-limits - outputs the current restrictions set for Quarantine. Output format: client-id: NUMBER/MAX-NUMBER SIZE/MAX-SIZE where: oNUMBER/MAX-NUMBER - current/maximum number of messages. If the maximum value is not set, 0 is output. oSIZE/MAX-SIZE - current/maximum size of messages in Quarantine (in bytes). If the maximum value is not set, 0 is output. oclient-id1 - "def" string. ototal - information on the whole database. •quarantine-send id-like [email1 email2 ...] - sends messages from Quarantine to the specified recipients (email1 email2 ...). If no recipient is specified, the messages are sent to their original recipients from the envelope. Message sending result is output in the following format: RES in sending (to RCPTS_LIST): id where: oRCPTS_LIST - actual list of message recipients. oRES - OK or ERROR, depending on the sending result. oid - path to the file with the message body. Output format: OK in sending (to <ai@drweb.com> <as@sd>): def/backup/6/00004DD6.maild.VQ80Ro •quarantine-add id from rcpt1 rcpt2... - adds the specified file to Quarantine, where from - message sender, rcptN - recipients. Addresses can be enclosed in angular brackets <>. If a file with the specified id does not exist, an error is output. |