"Fossies" - the Fresh Open Source Software Archive

Member "courier-1.2.2/courier/doc/cancelmsg.html" (22 Jan 2022, 3669 Bytes) of package /linux/misc/courier-1.2.2.tar.bz2:

As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) HTML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

A hint: This file contains one or more very long lines, so maybe it is better readable using the pure text view mode that shows the contents as wrapped lines within the browser window.

    1 <?xml version="1.0"?>
    2 <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>cancelmsg</title><link rel="stylesheet" type="text/css" href="style.css"/><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"/><link rel="home" href="#cancelmsg" title="cancelmsg"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
    4 Copyright 1998 - 2009 Double Precision, Inc.  See COPYING for distribution
    5 information.
    7 --></head><body><div class="refentry"><a id="cancelmsg" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>cancelmsg — Cancel an E-mail message</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">cancelmsg</code>  {<em class="replaceable"><code>msgid</code></em>} ["<em class="replaceable"><code>reason</code></em>"]</p></div></div><div class="refsect1"><a id="cancelmsg_description" shape="rect"> </a><h2>DESCRIPTION</h2><p>
    8 <span class="command"><strong>cancelmsg</strong></span> removes a message from the mail queue.
    9 There will be no more
   10 attempts to deliver this message, and a standard delivery failure notice is
   11 sent to the return address listed on the message. You can only cancel your own
   12 messages. The superuser can cancel any message.
   13 An attempt to cancel a message will fail
   14 if the message has already been sent (of course), or if a delivery attempt is
   15 currently in progress. Because a delivery attempt is usually started as soon
   16 as an E-mail message is added to the mail queue,
   17 a cancellation attempt is only effective if the message
   18 cannot be immediately delivered for some reason, or if the system
   19 is very busy and is working on a mail backlog.
   20 <span class="command"><strong>cancelmsg</strong></span> works by marking all pending recipients as
   21 undeliverable. A non-delivery report is then generated and sent in the normal
   22 fashion.</p><p>
   23 <em class="replaceable"><code>msgid</code></em> is the message queue id that can be obtained
   24 from the
   25 <a class="ulink" href="mailq.html" target="_top" shape="rect">
   26 <span class="citerefentry"><span class="refentrytitle">mailq</span>(1)</span>
   27 </a>,
   28 command. A <em class="replaceable"><code>reason</code></em> is optional. The message
   29 does not disappear into a black void.  The message will be returned as
   30 undeliverable, citing <em class="replaceable"><code>reason</code></em>. A generic error
   31 message will be used if
   32 <em class="replaceable"><code>reason</code></em> is not specified.</p></div><div class="refsect1"><a id="cancelmsg_bugs" shape="rect"> </a><h2>BUGS</h2><p>
   33 A non-delivery report may not be sent immediately, but delayed until the
   34 message's turn comes up in the scheduling queue.</p><p>
   35 There is no immediate indication if the message cancellation worked. A
   36 subsequent non-delivery report is the only indication of a successful cancel.
   37 If it doesn't come, it means the message wasn't cancelled in time.</p><p>
   38 A non-delivery report will not be sent for recipients whose delivery status
   39 notification does not include the <code class="literal">FAIL</code> notice.</p></div><div class="refsect1"><a id="cancelmsg_see_also" shape="rect"> </a><h2>SEE ALSO</h2><p>
   40 <a class="ulink" href="mailq.html" target="_top" shape="rect">
   41 <span class="citerefentry"><span class="refentrytitle">mailq</span>(1)</span>
   42 </a>,
   43 <a class="ulink" href="courier.html" target="_top" shape="rect">
   44 <span class="citerefentry"><span class="refentrytitle">courier</span>(8)</span>
   45 </a>.</p></div></div></body></html>