patches for DPDK stable branches
 help / color / mirror / Atom feed
From: Yuanhan Liu <yuanhan.liu@linux.intel.com>
To: Michal Krawczyk <mk@semihalf.com>
Cc: Yuanhan Liu <yuanhan.liu@linux.intel.com>,
	Jakub Palider <jpalider@gmail.com>,
	Jan Medala <jan.medala@outlook.com>,
	dpdk stable <stable@dpdk.org>
Subject: [dpdk-stable] patch 'net/ena: cleanup if refilling of Rx descriptors fails' has been queued to stable release 17.02.1
Date: Thu, 25 May 2017 17:48:55 +0800	[thread overview]
Message-ID: <1495705809-21416-83-git-send-email-yuanhan.liu@linux.intel.com> (raw)
In-Reply-To: <1495705809-21416-1-git-send-email-yuanhan.liu@linux.intel.com>

Hi,

FYI, your patch has been queued to stable release 17.02.1

Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet.
It will be pushed if I get no objections before 05/28/17. So please
shout if anyone has objections.

Thanks.

	--yliu

---
>From b96636f5792cd3925c536c08c24b6d88aed8dfdd Mon Sep 17 00:00:00 2001
From: Michal Krawczyk <mk@semihalf.com>
Date: Mon, 10 Apr 2017 16:28:10 +0200
Subject: [PATCH] net/ena: cleanup if refilling of Rx descriptors fails

[ upstream commit 2732e07ad1e54c648c8ca5bc6965af5bf607ba10 ]

If wrong number of descriptors for refilling was passed to the Rx
repopulate function, there was memory leak which caused memory pool to
run out of resources in longer go.

In case of fail when refilling Rx descriptors, all additional mbufs
have to be released.

Fixes: 1173fca25af9 ("ena: add polling-mode driver")

Signed-off-by: Michal Krawczyk <mk@semihalf.com>
Reviewed-by: Jakub Palider <jpalider@gmail.com>
Acked-by: Jan Medala <jan.medala@outlook.com>
---
 drivers/net/ena/ena_ethdev.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/drivers/net/ena/ena_ethdev.c b/drivers/net/ena/ena_ethdev.c
index b4c713f..e6e889b 100644
--- a/drivers/net/ena/ena_ethdev.c
+++ b/drivers/net/ena/ena_ethdev.c
@@ -1172,6 +1172,8 @@ static int ena_populate_rx_queue(struct ena_ring *rxq, unsigned int count)
 		rc = ena_com_add_single_rx_desc(rxq->ena_com_io_sq,
 						&ebuf, next_to_use_masked);
 		if (unlikely(rc)) {
+			rte_mempool_put_bulk(rxq->mb_pool, (void **)(&mbuf),
+					     count - i);
 			RTE_LOG(WARNING, PMD, "failed adding rx desc\n");
 			break;
 		}
-- 
1.9.0

  parent reply	other threads:[~2017-05-25  9:51 UTC|newest]

Thread overview: 159+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-05-25  9:47 [dpdk-stable] patch 'pci: fix device registration on FreeBSD' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'crypto/scheduler: fix include of local headers' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'kni: fix build with kernel 4.11' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'vfio: fix disabling INTx' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'mempool: fix crash when handler not found' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'vfio: fix secondary process start' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'nic_uio: fix device binding at boot' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'examples/ip_fragmentation: fix check of packet type' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'doc: fix a typo in howto guide' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/tap: fix possibly unterminated string' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/i40e: fix TC bitmap of VEB' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/i40e: fix memory allocation for hash table' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/mlx5: fix VLAN stripping indication' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/i40e: fix compile error' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/mlx5: fix startup when flow cannot be applied' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/bnx2x: fix transmit queue free threshold' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/e1000/base: fix multicast setting in VF' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/mlx5: fix supported packets types' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/i40e: fix a typo in flow' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/ixgbe/base: fix build error' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/mlx5: fix flow mark action handling' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/mlx5: fix drop queue creation error' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/mlx5: fix resources free in the right function' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/ixgbe: fix Rx queue blocking issue' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/ixgbe: fix all queues drop setting of DCB' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'net/ixgbe: fix multi-queue mode check in SRIOV mode' " Yuanhan Liu
2017-05-25  9:47 ` [dpdk-stable] patch 'app/testpmd: fix init config for multi-queue " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'app/testpmd: fix TC mapping in DCB init config' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: fix incorrect packet index reference' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/ixgbevf: set xstats id values' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/pcap: fix using mbuf after freeing it' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/ena: fix return of hash control flushing' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/vmxnet3: fix queue size changes' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: fix broadcast promiscuous mode setting' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/thunderx: fix 32-bit build' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/thunderx: fix build on FreeBSD' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/mlx4: update link status upon probing with LSC' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/nfp: clean Tx descriptor flags' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/nfp: fix packet/data length conversion' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/nfp: fix Rx interrupt' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: fix VLAN filter' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/mlx5: fix reusing Rx/Tx queues' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/ixgbe: fix TC bandwidth setting' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/mlx4: fix returned values upon failed probing' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/mlx5: " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/fm10k: fix pointer cast' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/qede: fix missing UDP protocol in RSS offload types' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/qede: fix VF RSS configuration' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/qede: prevent crash while changing MTU dynamically' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/mlx5: fix Tx when first segment size is too short' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/sfc: destroy event queue when Rx queue is released' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/sfc: destroy event queue when Tx " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/sfc: fix leak if EvQ DMA space allocation fails' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/sfc: use correct function to free scattered packet on Rx' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/fm10k: fix secondary process crash' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: fix VLAN promisc setting' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'vhost: try to shrink pfdset when fdset_add fails' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'vhost: change log levels in client mode' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/virtio-user: fix tapfds close' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/virtio-user: fix overflow' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/virtio: disable LSC interrupt if MSIX not enabled' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'vhost: fix multiple queue not enabled for old kernels' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'vhost: fix max queues' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'vhost: fix false sharing' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'vhost: fix fd leaks for vhost-user server mode' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/mlx5: fix an uninitialized variable' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'mk: fix shell errors when building with clang' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'mk: fix lib filtering when linking app' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'app/crypto-perf: fix AES CBC 128 test vectors' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'mk: fix quoting for ARM mtune argument' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'lib: fix IPv6 tunnel checksum' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'app/testpmd: " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'test/mempool: free mempool on exit' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/cxgbe: fix possible null pointer dereference' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: fix allocation check' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: fix VF link speed' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: add missing 25G " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/thunderx: use internal byte ordering macros' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: fix hash input set on X722' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/thunderx: fix stats access out of bounds' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/ena: fix Rx descriptors allocation' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/ena: fix delayed cleanup of Rx descriptors' " Yuanhan Liu
2017-05-25  9:48 ` Yuanhan Liu [this message]
2017-05-25  9:48 ` [dpdk-stable] patch 'net/ixgbe: fix generic filter return' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/i40e: fix VF link status update' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/ixgbe: fix duplicated check' " Yuanhan Liu
2017-05-25  9:48 ` [dpdk-stable] patch 'net/ixgbe: remove tpid check for flow director' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/bonding: allow configuring jumbo frames without slaves' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/mlx4: fix Rx after mbuf alloc failure' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/i40e: ensure vector mode is not used with QinQ' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/sfc: reset RSS channels back to 0 on close' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/virtio: fix queue notify' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/virtio-user: fix address on 32-bit system' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'vhost: fix dequeue zero copy' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'kni: fix ethtool support' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'crypto/scheduler: fix capability update' " Yuanhan Liu
2017-05-26  1:26   ` Zhang, Roy Fan
2017-05-25  9:49 ` [dpdk-stable] patch 'app/crypto-perf: fix crypto operation resubmission' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'crypto/qat: fix AES-GCM authentication length' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'crypto/qat: fix IV zero physical address' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'app/crypto-perf: fix AEAD tests when AAD is zero' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/l2fwd-crypto: " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/l2fwd-crypto: fix padding calculation' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'kni: fix possible memory leak' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples: fix build clean on FreeBSD' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/performance-thread: fix build " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/performance-thread: fix compilation on Suse 11 SP2' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'mbuf: fix missing includes in exported header' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'efd: fix missing include " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'cmdline: fix parsing' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/sfc: fix LSC interrupt support for UIO cases' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/i40e: fix setup when bulk is disabled' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/qede: fix default MAC address handling' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/qede: fix fastpath rings reset phase' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/qede: fix FW version string for VF' " Yuanhan Liu
2017-05-25 17:15   ` Mody, Rasesh
2017-05-25  9:49 ` [dpdk-stable] patch 'net/nfp: fix releasing muti-segment mbufs' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/ixgbe: remove useless item type check' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/ixgbe: fix type check for flow type' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/bonding: fix updating slave link status' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/ixgbe: fix ntuple filter for SCTP' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/virtio: fix MSI-X for modern devices' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/virtio: fix LSC setting' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/virtio: fix crash when closing twice' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'crypto/openssl: fix AAD capabilities for AES-GCM' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'crypto/openssl: fix AES-GCM capability' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'cryptodev: fix API AAD comments' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/l2fwd-crypto: fix packets array index' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'crypto/qat: fix dequeue statistics' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'cryptodev: fix API digest length comments' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'app/testpmd: fix crash at mbuf pool creation' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'app/testpmd: fix exit without freeing resources' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/performance-thread: fix build on FreeBSD 10.0' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/multi_process: fix timer update' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/l3fwd-power: fix handling no Rx queue' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/l3fwd-power: fix Rx descriptor size' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/load_balancer: fix Tx flush' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'examples/ethtool: fix link with ixgbe shared lib' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/thunderx: fix deadlock in Rx path' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'kni: fix crash caused by freeing mempool' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net: fix stripped VLAN flag for offload emulation' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/igb: fix VF MAC address setting' " Yuanhan Liu
2017-05-25  9:49 ` Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/ixgbe: fix default MAC " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/ixgbe: fix VF Rx mode for allmulticast disabled' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/ixgbe: fix setting MTU on stopped device' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/ixgbe: fix memory overflow in 32-bit SSE Rx' " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/i40e: " Yuanhan Liu
2017-05-25  9:49 ` [dpdk-stable] patch 'net/fm10k: " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'net/vmxnet3: fix build with gcc 7' " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'test/cmdline: fix missing break in switch' " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'app/testpmd: fix stack overwriting by flow command' " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'app/testpmd: fix MAC endian in " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'doc: explain zlib dependency for bnx2x' " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'eal/bsd: fix ioport write operation' " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'eal/bsd: fix read on PCI configuration space' " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'net/ixgbe: fix LSC interrupt' " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'net/mlx5: fix index handling for Tx ring' " Yuanhan Liu
2017-05-25  9:50 ` [dpdk-stable] patch 'net/mlx5: fix rollback when starting device' " Yuanhan Liu

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1495705809-21416-83-git-send-email-yuanhan.liu@linux.intel.com \
    --to=yuanhan.liu@linux.intel.com \
    --cc=jan.medala@outlook.com \
    --cc=jpalider@gmail.com \
    --cc=mk@semihalf.com \
    --cc=stable@dpdk.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).