~ubuntu-branches/ubuntu/vivid/syslog-ng/vivid-proposed

« back to all changes in this revision

Viewing changes to modules/afamqp/rabbitmq-c/tools/doc/amqp-publish.xml

  • Committer: Package Import Robot
  • Author(s): Gergely Nagy, Gergely Nagy
  • Date: 2013-11-04 15:27:37 UTC
  • mfrom: (1.3.12)
  • Revision ID: package-import@ubuntu.com-20131104152737-mqh6eqtna2xk97jq
Tags: 3.5.1-1
[ Gergely Nagy <algernon@madhouse-project.org> ]
* New upstream release.
  + Support auto-loading modules (Closes: #650814)
  + The SMTP module is available in syslog-ng-mod-smtp (Closes: #722746)
  + New modules: amqp, geoip, stomp, redis and smtp.
  + Multi-line input support (indented multiline and regexp-based)
  + Template type hinting for the MongoDB destination and $(format-json)
  + Support for unit suffixes in the configuration file
  + New filters, template functions and other miscellaneous changes
* New (team) maintainer, Laszlo Boszormenyi, Attila Szalay and myself
  added to Uploaders.
* Ship /var/lib/syslog-ng in the syslog-ng-core package, instead of
  creating it in the init script. Thanks Michael Biebl
  <biebl@debian.org> for the report & assistance. (Closes: #699942, #719910)
* Use dh-systemd for proper systemd-related maintainer scripts. Based on
  a patch by Michael Biebl <biebl@debian.org>. (Closes: #713982,
  #690067)
* Do not wait for syslog-ng to settle down during installation / update.
  This also fixes installing via debootstrap and a fake
  start-stop-daemon. (Closes: #714254)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.docbook.org/xml/4.5/docbookx.dtd"
 
3
[
 
4
<!ENTITY date SYSTEM "man-date.ent" >
 
5
]
 
6
>
 
7
<refentry lang="en">
 
8
    <refentryinfo>
 
9
        <productname>RabbitMQ C Client</productname>
 
10
        <authorgroup>
 
11
            <corpauthor>The RabbitMQ Team &lt;<ulink url="mailto:info@rabbitmq.com"><email>info@rabbitmq.com</email></ulink>&gt;</corpauthor>
 
12
        </authorgroup>
 
13
        <date>&date;</date>
 
14
    </refentryinfo>
 
15
 
 
16
    <refmeta>
 
17
        <refentrytitle>amqp-publish</refentrytitle>
 
18
        <manvolnum>1</manvolnum>
 
19
        <refmiscinfo class="manual">RabbitMQ C Client</refmiscinfo>
 
20
    </refmeta>
 
21
 
 
22
    <refnamediv>
 
23
        <refname>amqp-publish</refname>
 
24
        <refpurpose>Publish a message on an AMQP server</refpurpose>
 
25
    </refnamediv>
 
26
 
 
27
    <refsynopsisdiv>
 
28
        <cmdsynopsis>
 
29
            <command>amqp-publish</command>
 
30
            <arg choice="opt" rep="repeat">
 
31
                <replaceable>OPTION</replaceable>
 
32
            </arg>
 
33
        </cmdsynopsis>
 
34
    </refsynopsisdiv>
 
35
 
 
36
    <refsect1>
 
37
        <title>Description</title>
 
38
        <para>
 
39
            Publishes a message to an exchange on an AMQP server.
 
40
            Options allow the various properties of the message and
 
41
            parameters of the AMQP <function>basic.publish</function>
 
42
            method to be specified.
 
43
        </para>
 
44
        <para>
 
45
            By default, the message body is read from standard input.
 
46
            Alternatively, the <option>-b</option> option allows the message
 
47
            body to be provided as part of the command.
 
48
        </para>
 
49
    </refsect1>
 
50
 
 
51
    <refsect1>
 
52
        <title>Options</title>
 
53
        <variablelist>
 
54
            <varlistentry>
 
55
                <term><option>-e</option></term>
 
56
                <term><option>--exchange</option>=<replaceable class="parameter">exchange name</replaceable></term>
 
57
                <listitem>
 
58
                    <para>
 
59
                        The name of the exchange to publish to.  If
 
60
                        omitted, the default exchange (also known as
 
61
                        the nameless exchange) is used.
 
62
                    </para>
 
63
                </listitem>
 
64
            </varlistentry>
 
65
            <varlistentry>
 
66
                <term><option>-r</option></term>
 
67
                <term><option>--routing-key</option>=<replaceable class="parameter">routing key</replaceable></term>
 
68
                <listitem>
 
69
                    <para>
 
70
                        The routing key to publish with.  If omitted,
 
71
                        an empty routing key is assumed.  A routing
 
72
                        key must be specified when publishing to the
 
73
                        default exchange; in that case, accoding to
 
74
                        the AMQP specification, the routing key
 
75
                        corresponds to a queue name.
 
76
                    </para>
 
77
                </listitem>
 
78
            </varlistentry>
 
79
            <varlistentry>
 
80
                <term><option>-p</option></term>
 
81
                <term><option>--persistent</option></term>
 
82
                <listitem>
 
83
                    <para>
 
84
                        Use the persistent delivery mode.  Without
 
85
                        this option, non-persistent delivery is used.
 
86
                    </para>
 
87
                </listitem>
 
88
            </varlistentry>
 
89
            <varlistentry>
 
90
                <term><option>-C</option></term>
 
91
                <term><option>--content-type</option>=<replaceable class="parameter">MIME type</replaceable></term>
 
92
                <listitem>
 
93
                    <para>
 
94
                        Specifies the content-type property for the
 
95
                        message.  If omitted, the content-type
 
96
                        property is not set on the message.
 
97
                    </para>
 
98
                </listitem>
 
99
            </varlistentry>
 
100
            <varlistentry>
 
101
                <term><option>-E</option></term>
 
102
                <term><option>--content-encoding</option>=<replaceable class="parameter">content coding</replaceable></term>
 
103
                <listitem>
 
104
                    <para>
 
105
                        Specifies the content-encoding property for
 
106
                        the message.  If omitted, the content-encoding
 
107
                        property is not set on the message.
 
108
                    </para>
 
109
                </listitem>
 
110
            </varlistentry>
 
111
            <varlistentry>
 
112
                <term><option>-b</option></term>
 
113
                <term><option>--body</option>=<replaceable class="parameter">message body</replaceable></term>
 
114
                <listitem>
 
115
                    <para>
 
116
                        Specifies the message body.  If omitted, the
 
117
                        message body is read from standard input.
 
118
                    </para>
 
119
                </listitem>
 
120
            </varlistentry>
 
121
        </variablelist>
 
122
    </refsect1>
 
123
 
 
124
    <refsect1>
 
125
        <title>Examples</title>
 
126
        <variablelist>
 
127
            <varlistentry>
 
128
                <term>Send a short message, consisting of the word
 
129
                <quote><literal>Hello</literal></quote> to the queue
 
130
                <quote><systemitem
 
131
                class="resource">myqueue</systemitem></quote> via the
 
132
                default exchange:</term>
 
133
                <listitem>
 
134
                    <screen><prompt>$ </prompt><userinput>amqp-publish -r myqueue -b Hello</userinput></screen>
 
135
                </listitem>
 
136
            </varlistentry>
 
137
 
 
138
            <varlistentry>
 
139
                <term>Send some XML data from a file to the exchange
 
140
                <quote><systemitem
 
141
                class="resource">events</systemitem></quote>, with
 
142
                persistent delivery mode, setting the content-type
 
143
                property on the message to make the data format
 
144
                explicit:</term>
 
145
                <listitem>
 
146
                    <screen><prompt>$ </prompt><userinput>amqp-publish -e events -p -C text/xml &lt;event.xml</userinput></screen>
 
147
                </listitem>
 
148
            </varlistentry>
 
149
        </variablelist>
 
150
    </refsect1>
 
151
 
 
152
    <refsect1>
 
153
        <title>See also</title>
 
154
        <para>
 
155
            <citerefentry><refentrytitle>librabbitmq-tools</refentrytitle><manvolnum>7</manvolnum></citerefentry>
 
156
            describes connection-related options common to all the
 
157
            RabbitMQ C Client tools.
 
158
        </para>
 
159
    </refsect1>
 
160
</refentry>