.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 >0, 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 "DJabberd::Delivery::ComponentConnection 3"
.TH DJabberd::Delivery::ComponentConnection 3 2023-07-25 "perl v5.38.0" "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
DJabberd::Delivery::ComponentConnection \- Delivery through a JEP\-0114 component connection
.SH INTRODUCTION
.IX Header "INTRODUCTION"
This class allows you to route stanzas over a JEP\-0114 component connection. It can operate
both as a server (to which you can connect third-party JEP\-0114 components) and as a client,
where a DJabberd VHost itself acts as a component.
.PP
The server support allows you to connect third-party components and transports such as
the popular pyXXXt range of transports to other IM networks.
.PP
The client support means that you can expose any DJabberd VHost as a JEP\-0114 component
and connect the resulting component to any other Jabberd implementation which supports
JEP\-0114. In effect this allows you to use DJabberd as a platform to write a component while
retaining your existing Jabber server implementation.
.PP
Note: The server mode doesn't currently work. See DJabberd::Component::External.
This module may change name at some point; the combination of the client and server modes into
on module is not finalized.
.SH LICENCE
.IX Header "LICENCE"
Copyright 2006 Martin Atkins and Six Apart
.PP
This library is part of the Jabber server DJabberd. It can be modified and distributed
under the same terms as DJabberd itself.