.\" -*- 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::LocalVHosts 3"
.TH DJabberd::Delivery::LocalVHosts 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::LocalVHosts \- Controlled delivery to other local VHosts
.SH SYNOPSIS
.IX Header "SYNOPSIS"
<VHost mydomain.com>
.PP
.Vb 1
\&  [...]
\&
\&  <Plugin DJabberd::Delivery::LocalVHosts>
\&    AllowVHost component1.mydomain.com
\&    AllowVHost component2.mydomain.com
\&    ...
\&  </Plugin>
\&
\&  [...]
.Ve
.PP
</VHost>
.PP
This delivery plugin provides a shortcut for delivering messages between two
domains that are running on the same server. It also allows inter-VHost
communication on hosts that do not have S2S enabled at all, enabling admins
to create a closed pool of vhosts on one server that can only talk to one another,
if configuring S2S is impossible or inconvenient.
.PP
This plugin won't do anything at all unless you allow at least one vhost as
shown in the example above. By explicitly listing the appropriate services
you can create segregated pools of vhosts that can't communicate between
each other but can communicate within the configured bounds.
.PP
TODO: more docs