* [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0
@ 2023-07-25 7:41 Wei Fang
2023-07-25 16:51 ` Alexander H Duyck
2023-07-27 4:20 ` patchwork-bot+netdevbpf
0 siblings, 2 replies; 8+ messages in thread
From: Wei Fang @ 2023-07-25 7:41 UTC (permalink / raw)
To: davem, edumazet, kuba, shenwei.wang, xiaoning.wang, pabeni,
netdev
Cc: linux-imx, linux-kernel
According to the clarification [1] in the latest napi.rst, the tx
processing cannot call any XDP (or page pool) APIs if the "budget"
is 0. Because NAPI is called with the budget of 0 (such as netpoll)
indicates we may be in an IRQ context, however, we cannot use the
page pool from IRQ context.
[1] https://lore.kernel.org/all/20230720161323.2025379-1-kuba@kernel.org/
Fixes: 20f797399035 ("net: fec: recycle pages for transmitted XDP frames")
Signed-off-by: Wei Fang <wei.fang@nxp.com>
Suggested-by: Jakub Kicinski <kuba@kernel.org>
---
drivers/net/ethernet/freescale/fec_main.c | 16 ++++++++++++----
1 file changed, 12 insertions(+), 4 deletions(-)
diff --git a/drivers/net/ethernet/freescale/fec_main.c b/drivers/net/ethernet/freescale/fec_main.c
index 073d61619336..66b5cbdb43b9 100644
--- a/drivers/net/ethernet/freescale/fec_main.c
+++ b/drivers/net/ethernet/freescale/fec_main.c
@@ -1372,7 +1372,7 @@ fec_enet_hwtstamp(struct fec_enet_private *fep, unsigned ts,
}
static void
-fec_enet_tx_queue(struct net_device *ndev, u16 queue_id)
+fec_enet_tx_queue(struct net_device *ndev, u16 queue_id, int budget)
{
struct fec_enet_private *fep;
struct xdp_frame *xdpf;
@@ -1416,6 +1416,14 @@ fec_enet_tx_queue(struct net_device *ndev, u16 queue_id)
if (!skb)
goto tx_buf_done;
} else {
+ /* Tx processing cannot call any XDP (or page pool) APIs if
+ * the "budget" is 0. Because NAPI is called with budget of
+ * 0 (such as netpoll) indicates we may be in an IRQ context,
+ * however, we can't use the page pool from IRQ context.
+ */
+ if (unlikely(!budget))
+ break;
+
xdpf = txq->tx_buf[index].xdp;
if (bdp->cbd_bufaddr)
dma_unmap_single(&fep->pdev->dev,
@@ -1508,14 +1516,14 @@ fec_enet_tx_queue(struct net_device *ndev, u16 queue_id)
writel(0, txq->bd.reg_desc_active);
}
-static void fec_enet_tx(struct net_device *ndev)
+static void fec_enet_tx(struct net_device *ndev, int budget)
{
struct fec_enet_private *fep = netdev_priv(ndev);
int i;
/* Make sure that AVB queues are processed first. */
for (i = fep->num_tx_queues - 1; i >= 0; i--)
- fec_enet_tx_queue(ndev, i);
+ fec_enet_tx_queue(ndev, i, budget);
}
static void fec_enet_update_cbd(struct fec_enet_priv_rx_q *rxq,
@@ -1858,7 +1866,7 @@ static int fec_enet_rx_napi(struct napi_struct *napi, int budget)
do {
done += fec_enet_rx(ndev, budget - done);
- fec_enet_tx(ndev);
+ fec_enet_tx(ndev, budget);
} while ((done < budget) && fec_enet_collect_events(fep));
if (done < budget) {
--
2.25.1
^ permalink raw reply related [flat|nested] 8+ messages in thread
* Re: [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0
2023-07-25 7:41 [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0 Wei Fang
@ 2023-07-25 16:51 ` Alexander H Duyck
2023-07-26 3:40 ` Wei Fang
2023-07-27 4:20 ` patchwork-bot+netdevbpf
1 sibling, 1 reply; 8+ messages in thread
From: Alexander H Duyck @ 2023-07-25 16:51 UTC (permalink / raw)
To: Wei Fang, davem, edumazet, kuba, shenwei.wang, xiaoning.wang,
pabeni, netdev
Cc: linux-imx, linux-kernel
On Tue, 2023-07-25 at 15:41 +0800, Wei Fang wrote:
> According to the clarification [1] in the latest napi.rst, the tx
> processing cannot call any XDP (or page pool) APIs if the "budget"
> is 0. Because NAPI is called with the budget of 0 (such as netpoll)
> indicates we may be in an IRQ context, however, we cannot use the
> page pool from IRQ context.
>
> [1] https://lore.kernel.org/all/20230720161323.2025379-1-kuba@kernel.org/
>
> Fixes: 20f797399035 ("net: fec: recycle pages for transmitted XDP frames")
> Signed-off-by: Wei Fang <wei.fang@nxp.com>
> Suggested-by: Jakub Kicinski <kuba@kernel.org>
> ---
> drivers/net/ethernet/freescale/fec_main.c | 16 ++++++++++++----
> 1 file changed, 12 insertions(+), 4 deletions(-)
>
> diff --git a/drivers/net/ethernet/freescale/fec_main.c b/drivers/net/ethernet/freescale/fec_main.c
> index 073d61619336..66b5cbdb43b9 100644
> --- a/drivers/net/ethernet/freescale/fec_main.c
> +++ b/drivers/net/ethernet/freescale/fec_main.c
> @@ -1372,7 +1372,7 @@ fec_enet_hwtstamp(struct fec_enet_private *fep, unsigned ts,
> }
>
> static void
> -fec_enet_tx_queue(struct net_device *ndev, u16 queue_id)
> +fec_enet_tx_queue(struct net_device *ndev, u16 queue_id, int budget)
> {
> struct fec_enet_private *fep;
> struct xdp_frame *xdpf;
> @@ -1416,6 +1416,14 @@ fec_enet_tx_queue(struct net_device *ndev, u16 queue_id)
> if (!skb)
> goto tx_buf_done;
> } else {
> + /* Tx processing cannot call any XDP (or page pool) APIs if
> + * the "budget" is 0. Because NAPI is called with budget of
> + * 0 (such as netpoll) indicates we may be in an IRQ context,
> + * however, we can't use the page pool from IRQ context.
> + */
> + if (unlikely(!budget))
> + break;
> +
> xdpf = txq->tx_buf[index].xdp;
> if (bdp->cbd_bufaddr)
> dma_unmap_single(&fep->pdev->dev,
This statement isn't correct. There are napi enabled and non-napi
versions of these calls. This is the reason for things like the
"allow_direct" parameter in page_pool_put_full_page and the
"napi_direct" parameter in __xdp_return.
By blocking on these cases you can end up hanging the Tx queue which is
going to break netpoll as you are going to stall the ring on XDP
packets if they are already in the queue.
From what I can tell your driver is using xdp_return_frame in the case
of an XDP frame which doesn't make use of the NAPI optimizations in
freeing from what I can tell. The NAPI optimized version is
xdp_return_frame_rx.
> @@ -1508,14 +1516,14 @@ fec_enet_tx_queue(struct net_device *ndev, u16 queue_id)
> writel(0, txq->bd.reg_desc_active);
> }
>
> -static void fec_enet_tx(struct net_device *ndev)
> +static void fec_enet_tx(struct net_device *ndev, int budget)
> {
> struct fec_enet_private *fep = netdev_priv(ndev);
> int i;
>
> /* Make sure that AVB queues are processed first. */
> for (i = fep->num_tx_queues - 1; i >= 0; i--)
> - fec_enet_tx_queue(ndev, i);
> + fec_enet_tx_queue(ndev, i, budget);
> }
>
> static void fec_enet_update_cbd(struct fec_enet_priv_rx_q *rxq,
> @@ -1858,7 +1866,7 @@ static int fec_enet_rx_napi(struct napi_struct *napi, int budget)
>
> do {
> done += fec_enet_rx(ndev, budget - done);
> - fec_enet_tx(ndev);
> + fec_enet_tx(ndev, budget);
> } while ((done < budget) && fec_enet_collect_events(fep));
>
> if (done < budget) {
Since you are passing budget, one optimization you could make use of
would be napi_consume_skb in your Tx path instead of dev_kfree_skb_any.
^ permalink raw reply [flat|nested] 8+ messages in thread
* RE: [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0
2023-07-25 16:51 ` Alexander H Duyck
@ 2023-07-26 3:40 ` Wei Fang
2023-07-26 15:53 ` Alexander Duyck
0 siblings, 1 reply; 8+ messages in thread
From: Wei Fang @ 2023-07-26 3:40 UTC (permalink / raw)
To: Alexander H Duyck
Cc: dl-linux-imx, linux-kernel@vger.kernel.org, davem@davemloft.net,
edumazet@google.com, kuba@kernel.org, Shenwei Wang, Clark Wang,
pabeni@redhat.com, netdev@vger.kernel.org
Hi Alexander,
> > @@ -1416,6 +1416,14 @@ fec_enet_tx_queue(struct net_device *ndev,
> u16 queue_id)
> > if (!skb)
> > goto tx_buf_done;
> > } else {
> > + /* Tx processing cannot call any XDP (or page pool) APIs if
> > + * the "budget" is 0. Because NAPI is called with budget of
> > + * 0 (such as netpoll) indicates we may be in an IRQ context,
> > + * however, we can't use the page pool from IRQ context.
> > + */
> > + if (unlikely(!budget))
> > + break;
> > +
> > xdpf = txq->tx_buf[index].xdp;
> > if (bdp->cbd_bufaddr)
> > dma_unmap_single(&fep->pdev->dev,
>
> This statement isn't correct. There are napi enabled and non-napi
> versions of these calls. This is the reason for things like the
> "allow_direct" parameter in page_pool_put_full_page and the
> "napi_direct" parameter in __xdp_return.
>
> By blocking on these cases you can end up hanging the Tx queue which is
> going to break netpoll as you are going to stall the ring on XDP
> packets if they are already in the queue.
>
> From what I can tell your driver is using xdp_return_frame in the case
> of an XDP frame which doesn't make use of the NAPI optimizations in
> freeing from what I can tell. The NAPI optimized version is
> xdp_return_frame_rx.
>
So you mean it is safe to use xdp_return_frame no matter in NAPI context
or non-NAPI context? And xdp_return_frame_rx_napi must be used in NAPI
context? If so, I think I must have misunderstood, then this patch is not necessary.
> > @@ -1508,14 +1516,14 @@ fec_enet_tx_queue(struct net_device *ndev,
> u16 queue_id)
> > writel(0, txq->bd.reg_desc_active);
> > }
> >
> > -static void fec_enet_tx(struct net_device *ndev)
> > +static void fec_enet_tx(struct net_device *ndev, int budget)
> > {
> > struct fec_enet_private *fep = netdev_priv(ndev);
> > int i;
> >
> > /* Make sure that AVB queues are processed first. */
> > for (i = fep->num_tx_queues - 1; i >= 0; i--)
> > - fec_enet_tx_queue(ndev, i);
> > + fec_enet_tx_queue(ndev, i, budget);
> > }
> >
> > static void fec_enet_update_cbd(struct fec_enet_priv_rx_q *rxq,
> > @@ -1858,7 +1866,7 @@ static int fec_enet_rx_napi(struct napi_struct
> *napi, int budget)
> >
> > do {
> > done += fec_enet_rx(ndev, budget - done);
> > - fec_enet_tx(ndev);
> > + fec_enet_tx(ndev, budget);
> > } while ((done < budget) && fec_enet_collect_events(fep));
> >
> > if (done < budget) {
>
> Since you are passing budget, one optimization you could make use of
> would be napi_consume_skb in your Tx path instead of dev_kfree_skb_any.
That's good suggestion, I think I can add this optimization in my XDP_TX support
patch. Thanks!
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0
2023-07-26 3:40 ` Wei Fang
@ 2023-07-26 15:53 ` Alexander Duyck
2023-07-27 2:08 ` Wei Fang
0 siblings, 1 reply; 8+ messages in thread
From: Alexander Duyck @ 2023-07-26 15:53 UTC (permalink / raw)
To: Wei Fang
Cc: dl-linux-imx, linux-kernel@vger.kernel.org, davem@davemloft.net,
edumazet@google.com, kuba@kernel.org, Shenwei Wang, Clark Wang,
pabeni@redhat.com, netdev@vger.kernel.org
On Tue, Jul 25, 2023 at 8:40 PM Wei Fang <wei.fang@nxp.com> wrote:
>
> Hi Alexander,
>
> > > @@ -1416,6 +1416,14 @@ fec_enet_tx_queue(struct net_device *ndev,
> > u16 queue_id)
> > > if (!skb)
> > > goto tx_buf_done;
> > > } else {
> > > + /* Tx processing cannot call any XDP (or page pool) APIs if
> > > + * the "budget" is 0. Because NAPI is called with budget of
> > > + * 0 (such as netpoll) indicates we may be in an IRQ context,
> > > + * however, we can't use the page pool from IRQ context.
> > > + */
> > > + if (unlikely(!budget))
> > > + break;
> > > +
> > > xdpf = txq->tx_buf[index].xdp;
> > > if (bdp->cbd_bufaddr)
> > > dma_unmap_single(&fep->pdev->dev,
> >
> > This statement isn't correct. There are napi enabled and non-napi
> > versions of these calls. This is the reason for things like the
> > "allow_direct" parameter in page_pool_put_full_page and the
> > "napi_direct" parameter in __xdp_return.
> >
> > By blocking on these cases you can end up hanging the Tx queue which is
> > going to break netpoll as you are going to stall the ring on XDP
> > packets if they are already in the queue.
> >
> > From what I can tell your driver is using xdp_return_frame in the case
> > of an XDP frame which doesn't make use of the NAPI optimizations in
> > freeing from what I can tell. The NAPI optimized version is
> > xdp_return_frame_rx.
> >
> So you mean it is safe to use xdp_return_frame no matter in NAPI context
> or non-NAPI context? And xdp_return_frame_rx_napi must be used in NAPI
> context? If so, I think I must have misunderstood, then this patch is not necessary.
Actually after talking with Jakub a bit more there is an issue here,
but not freeing the frames isn't the solution. We likely need to just
fix the page pool code so that it doesn't attempt to recycle the
frames if operating in IRQ context.
The way this is dealt with for skbs is that we queue skbs if we are in
IRQ context so that it can be deferred to be freed by the
net_tx_action. We likely need to look at doing something similar for
page_pool pages or XDP frames.
> > > @@ -1508,14 +1516,14 @@ fec_enet_tx_queue(struct net_device *ndev,
> > u16 queue_id)
> > > writel(0, txq->bd.reg_desc_active);
> > > }
> > >
> > > -static void fec_enet_tx(struct net_device *ndev)
> > > +static void fec_enet_tx(struct net_device *ndev, int budget)
> > > {
> > > struct fec_enet_private *fep = netdev_priv(ndev);
> > > int i;
> > >
> > > /* Make sure that AVB queues are processed first. */
> > > for (i = fep->num_tx_queues - 1; i >= 0; i--)
> > > - fec_enet_tx_queue(ndev, i);
> > > + fec_enet_tx_queue(ndev, i, budget);
> > > }
> > >
> > > static void fec_enet_update_cbd(struct fec_enet_priv_rx_q *rxq,
> > > @@ -1858,7 +1866,7 @@ static int fec_enet_rx_napi(struct napi_struct
> > *napi, int budget)
> > >
> > > do {
> > > done += fec_enet_rx(ndev, budget - done);
> > > - fec_enet_tx(ndev);
> > > + fec_enet_tx(ndev, budget);
> > > } while ((done < budget) && fec_enet_collect_events(fep));
> > >
> > > if (done < budget) {
> >
> > Since you are passing budget, one optimization you could make use of
> > would be napi_consume_skb in your Tx path instead of dev_kfree_skb_any.
> That's good suggestion, I think I can add this optimization in my XDP_TX support
> patch. Thanks!
^ permalink raw reply [flat|nested] 8+ messages in thread
* RE: [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0
2023-07-26 15:53 ` Alexander Duyck
@ 2023-07-27 2:08 ` Wei Fang
2023-07-27 4:14 ` Jakub Kicinski
0 siblings, 1 reply; 8+ messages in thread
From: Wei Fang @ 2023-07-27 2:08 UTC (permalink / raw)
To: Alexander Duyck
Cc: dl-linux-imx, linux-kernel@vger.kernel.org, davem@davemloft.net,
edumazet@google.com, kuba@kernel.org, Shenwei Wang, Clark Wang,
pabeni@redhat.com, netdev@vger.kernel.org
> > > This statement isn't correct. There are napi enabled and non-napi
> > > versions of these calls. This is the reason for things like the
> > > "allow_direct" parameter in page_pool_put_full_page and the
> > > "napi_direct" parameter in __xdp_return.
> > >
> > > By blocking on these cases you can end up hanging the Tx queue which is
> > > going to break netpoll as you are going to stall the ring on XDP
> > > packets if they are already in the queue.
> > >
> > > From what I can tell your driver is using xdp_return_frame in the case
> > > of an XDP frame which doesn't make use of the NAPI optimizations in
> > > freeing from what I can tell. The NAPI optimized version is
> > > xdp_return_frame_rx.
> > >
> > So you mean it is safe to use xdp_return_frame no matter in NAPI context
> > or non-NAPI context? And xdp_return_frame_rx_napi must be used in NAPI
> > context? If so, I think I must have misunderstood, then this patch is not
> necessary.
>
> Actually after talking with Jakub a bit more there is an issue here,
> but not freeing the frames isn't the solution. We likely need to just
> fix the page pool code so that it doesn't attempt to recycle the
> frames if operating in IRQ context.
>
> The way this is dealt with for skbs is that we queue skbs if we are in
> IRQ context so that it can be deferred to be freed by the
> net_tx_action. We likely need to look at doing something similar for
> page_pool pages or XDP frames.
>
After reading your discussion with Jakub, I understand this issue a bit more.
But we are not sure when this issue will be fixed in page pool, currently we
can only tolerate a delay in sending of a netpoll message. So I think this patch
is necessary, and I will refine it in the future when the page pool has fixed the
issue. In addition, as you mentioned before, napi_consume_skb should be
used to instead of dev_kfree_skb_any, so I will improve this patch in version 2.
Thanks.
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0
2023-07-27 2:08 ` Wei Fang
@ 2023-07-27 4:14 ` Jakub Kicinski
2023-07-27 5:32 ` Wei Fang
0 siblings, 1 reply; 8+ messages in thread
From: Jakub Kicinski @ 2023-07-27 4:14 UTC (permalink / raw)
To: Wei Fang
Cc: Alexander Duyck, dl-linux-imx, linux-kernel@vger.kernel.org,
davem@davemloft.net, edumazet@google.com, Shenwei Wang,
Clark Wang, pabeni@redhat.com, netdev@vger.kernel.org
On Thu, 27 Jul 2023 02:08:32 +0000 Wei Fang wrote:
> > Actually after talking with Jakub a bit more there is an issue here,
> > but not freeing the frames isn't the solution. We likely need to just
> > fix the page pool code so that it doesn't attempt to recycle the
> > frames if operating in IRQ context.
> >
> > The way this is dealt with for skbs is that we queue skbs if we are in
> > IRQ context so that it can be deferred to be freed by the
> > net_tx_action. We likely need to look at doing something similar for
> > page_pool pages or XDP frames.
> >
> After reading your discussion with Jakub, I understand this issue a bit more.
> But we are not sure when this issue will be fixed in page pool, currently we
> can only tolerate a delay in sending of a netpoll message. So I think this patch
> is necessary, and I will refine it in the future when the page pool has fixed the
> issue. In addition, as you mentioned before, napi_consume_skb should be
> used to instead of dev_kfree_skb_any, so I will improve this patch in version 2.
I think so too, since the patch can only help, you already wrote it and
it won't be extra backporting work since the code is only present in
6.5 - I think it's worth applying. And we can refine things as page pool
limitations get listed (the napi_consume_skb() is net-next material,
anyway).
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0
2023-07-25 7:41 [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0 Wei Fang
2023-07-25 16:51 ` Alexander H Duyck
@ 2023-07-27 4:20 ` patchwork-bot+netdevbpf
1 sibling, 0 replies; 8+ messages in thread
From: patchwork-bot+netdevbpf @ 2023-07-27 4:20 UTC (permalink / raw)
To: Wei Fang
Cc: davem, edumazet, kuba, shenwei.wang, xiaoning.wang, pabeni,
netdev, linux-imx, linux-kernel
Hello:
This patch was applied to netdev/net.git (main)
by Jakub Kicinski <kuba@kernel.org>:
On Tue, 25 Jul 2023 15:41:48 +0800 you wrote:
> According to the clarification [1] in the latest napi.rst, the tx
> processing cannot call any XDP (or page pool) APIs if the "budget"
> is 0. Because NAPI is called with the budget of 0 (such as netpoll)
> indicates we may be in an IRQ context, however, we cannot use the
> page pool from IRQ context.
>
> [1] https://lore.kernel.org/all/20230720161323.2025379-1-kuba@kernel.org/
>
> [...]
Here is the summary with links:
- [net] net: fec: tx processing does not call XDP APIs if budget is 0
https://git.kernel.org/netdev/net/c/15cec633fc7b
You are awesome, thank you!
--
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html
^ permalink raw reply [flat|nested] 8+ messages in thread
* RE: [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0
2023-07-27 4:14 ` Jakub Kicinski
@ 2023-07-27 5:32 ` Wei Fang
0 siblings, 0 replies; 8+ messages in thread
From: Wei Fang @ 2023-07-27 5:32 UTC (permalink / raw)
To: Jakub Kicinski
Cc: Alexander Duyck, dl-linux-imx, linux-kernel@vger.kernel.org,
davem@davemloft.net, edumazet@google.com, Shenwei Wang,
Clark Wang, pabeni@redhat.com, netdev@vger.kernel.org
> On Thu, 27 Jul 2023 02:08:32 +0000 Wei Fang wrote:
> > > Actually after talking with Jakub a bit more there is an issue here,
> > > but not freeing the frames isn't the solution. We likely need to
> > > just fix the page pool code so that it doesn't attempt to recycle
> > > the frames if operating in IRQ context.
> > >
> > > The way this is dealt with for skbs is that we queue skbs if we are
> > > in IRQ context so that it can be deferred to be freed by the
> > > net_tx_action. We likely need to look at doing something similar for
> > > page_pool pages or XDP frames.
> > >
> > After reading your discussion with Jakub, I understand this issue a bit more.
> > But we are not sure when this issue will be fixed in page pool,
> > currently we can only tolerate a delay in sending of a netpoll
> > message. So I think this patch is necessary, and I will refine it in
> > the future when the page pool has fixed the issue. In addition, as you
> > mentioned before, napi_consume_skb should be used to instead of
> dev_kfree_skb_any, so I will improve this patch in version 2.
>
> I think so too, since the patch can only help, you already wrote it and it won't
> be extra backporting work since the code is only present in
> 6.5 - I think it's worth applying. And we can refine things as page pool
> limitations get listed (the napi_consume_skb() is net-next material, anyway).
Okay, thank you. :)
^ permalink raw reply [flat|nested] 8+ messages in thread
end of thread, other threads:[~2023-07-27 5:33 UTC | newest]
Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-07-25 7:41 [PATCH net] net: fec: tx processing does not call XDP APIs if budget is 0 Wei Fang
2023-07-25 16:51 ` Alexander H Duyck
2023-07-26 3:40 ` Wei Fang
2023-07-26 15:53 ` Alexander Duyck
2023-07-27 2:08 ` Wei Fang
2023-07-27 4:14 ` Jakub Kicinski
2023-07-27 5:32 ` Wei Fang
2023-07-27 4:20 ` patchwork-bot+netdevbpf
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).