* [PATCH] PCI: histb: add power control GPIO for PCIe slot
@ 2018-01-23 1:04 Shawn Guo
2018-01-23 1:12 ` Fabio Estevam
` (2 more replies)
0 siblings, 3 replies; 7+ messages in thread
From: Shawn Guo @ 2018-01-23 1:04 UTC (permalink / raw)
To: Bjorn Helgaas
Cc: Rob Herring, linux-pci, devicetree, project-aspen-dev,
Jianguo Sun, Shawn Guo
From: Jianguo Sun <sunjianguo1@huawei.com>
Besides the GPIO for controlling reset, there is also possibly another
GPIO for turning on/off the power of PCIe slot. Let's add the support
for that with another optional device tree property 'power-gpios'.
Signed-off-by: Jianguo Sun <sunjianguo1@huawei.com>
Signed-off-by: Shawn Guo <shawn.guo@linaro.org>
---
.../bindings/pci/hisilicon-histb-pcie.txt | 1 +
drivers/pci/dwc/pcie-histb.c | 28 +++++++++++++++++++---
2 files changed, 26 insertions(+), 3 deletions(-)
diff --git a/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt b/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
index c84bc027930b..597397a048f8 100644
--- a/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
+++ b/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
@@ -33,6 +33,7 @@ Required properties
"bus": bus reset.
Optional properties:
+- power-gpios: The gpio to control the power of PCIe slot.
- reset-gpios: The gpio to generate PCIe PERST# assert and deassert signal.
- phys: List of phandle and phy mode specifier, should be 0.
- phy-names: Must be "phy".
diff --git a/drivers/pci/dwc/pcie-histb.c b/drivers/pci/dwc/pcie-histb.c
index 33b01b734d7d..2a6b18619b25 100644
--- a/drivers/pci/dwc/pcie-histb.c
+++ b/drivers/pci/dwc/pcie-histb.c
@@ -63,6 +63,7 @@ struct histb_pcie {
struct reset_control *sys_reset;
struct reset_control *bus_reset;
void __iomem *ctrl;
+ int power_gpio;
int reset_gpio;
};
@@ -230,6 +231,8 @@ static void histb_pcie_host_disable(struct histb_pcie *hipcie)
if (gpio_is_valid(hipcie->reset_gpio))
gpio_set_value_cansleep(hipcie->reset_gpio, 0);
+ if (gpio_is_valid(hipcie->power_gpio))
+ gpio_set_value_cansleep(hipcie->power_gpio, 0);
}
static int histb_pcie_host_enable(struct pcie_port *pp)
@@ -240,8 +243,14 @@ static int histb_pcie_host_enable(struct pcie_port *pp)
int ret;
/* power on PCIe device if have */
- if (gpio_is_valid(hipcie->reset_gpio))
+ if (gpio_is_valid(hipcie->power_gpio))
+ gpio_set_value_cansleep(hipcie->power_gpio, 1);
+
+ if (gpio_is_valid(hipcie->reset_gpio)) {
+ gpio_set_value_cansleep(hipcie->reset_gpio, 0);
+ mdelay(10);
gpio_set_value_cansleep(hipcie->reset_gpio, 1);
+ }
ret = clk_prepare_enable(hipcie->bus_clk);
if (ret) {
@@ -335,15 +344,28 @@ static int histb_pcie_probe(struct platform_device *pdev)
return PTR_ERR(pci->dbi_base);
}
+ hipcie->power_gpio = of_get_named_gpio_flags(np,
+ "power-gpios", 0, &of_flags);
+ if (of_flags & OF_GPIO_ACTIVE_LOW)
+ flag |= GPIOF_ACTIVE_LOW;
+ if (gpio_is_valid(hipcie->power_gpio)) {
+ ret = devm_gpio_request_one(dev, hipcie->power_gpio,
+ flag, "PCIe device power control");
+ if (ret) {
+ dev_err(dev, "unable to request power gpio\n");
+ return ret;
+ }
+ }
+
hipcie->reset_gpio = of_get_named_gpio_flags(np,
"reset-gpios", 0, &of_flags);
if (of_flags & OF_GPIO_ACTIVE_LOW)
flag |= GPIOF_ACTIVE_LOW;
if (gpio_is_valid(hipcie->reset_gpio)) {
ret = devm_gpio_request_one(dev, hipcie->reset_gpio,
- flag, "PCIe device power control");
+ flag, "PCIe device reset control");
if (ret) {
- dev_err(dev, "unable to request gpio\n");
+ dev_err(dev, "unable to request reset gpio\n");
return ret;
}
}
--
1.9.1
^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [PATCH] PCI: histb: add power control GPIO for PCIe slot
2018-01-23 1:04 [PATCH] PCI: histb: add power control GPIO for PCIe slot Shawn Guo
@ 2018-01-23 1:12 ` Fabio Estevam
2018-01-23 10:54 ` Shawn Guo
[not found] ` <1516669477-20151-1-git-send-email-shawn.guo-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org>
2018-03-02 12:10 ` Lorenzo Pieralisi
2 siblings, 1 reply; 7+ messages in thread
From: Fabio Estevam @ 2018-01-23 1:12 UTC (permalink / raw)
To: Shawn Guo
Cc: Bjorn Helgaas, Rob Herring, linux-pci,
open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS,
project-aspen-dev, Jianguo Sun
Hi Shawn,
On Mon, Jan 22, 2018 at 11:04 PM, Shawn Guo <shawn.guo@linaro.org> wrote:
> From: Jianguo Sun <sunjianguo1@huawei.com>
>
> Besides the GPIO for controlling reset, there is also possibly another
> GPIO for turning on/off the power of PCIe slot. Let's add the support
> for that with another optional device tree property 'power-gpios'.
It seems that a better approach would be to add regulator support
instead as it is more general.
We do this in drivers/pci/dwc/pci-imx6.c.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [project-aspen-dev] [PATCH] PCI: histb: add power control GPIO for PCIe slot
[not found] ` <1516669477-20151-1-git-send-email-shawn.guo-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org>
@ 2018-01-23 9:39 ` Daniel Thompson
[not found] ` <20180123093944.rxysbjm2u6suycco-Xg7FH8f/bVM@public.gmane.org>
0 siblings, 1 reply; 7+ messages in thread
From: Daniel Thompson @ 2018-01-23 9:39 UTC (permalink / raw)
To: Shawn Guo
Cc: Bjorn Helgaas, Rob Herring, linux-pci-u79uwXL29TY76Z2rM5mHXA,
devicetree-u79uwXL29TY76Z2rM5mHXA,
project-aspen-dev-QSEj5FYQhm4dnm+yROfE0A, Jianguo Sun
On Tue, Jan 23, 2018 at 09:04:37AM +0800, Shawn Guo wrote:
> From: Jianguo Sun <sunjianguo1-hv44wF8Li93QT0dZR+AlfA@public.gmane.org>
>
> Besides the GPIO for controlling reset, there is also possibly another
> GPIO for turning on/off the power of PCIe slot. Let's add the support
> for that with another optional device tree property 'power-gpios'.
>
> Signed-off-by: Jianguo Sun <sunjianguo1-hv44wF8Li93QT0dZR+AlfA@public.gmane.org>
> Signed-off-by: Shawn Guo <shawn.guo-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org>
> ---
> .../bindings/pci/hisilicon-histb-pcie.txt | 1 +
> drivers/pci/dwc/pcie-histb.c | 28 +++++++++++++++++++---
> 2 files changed, 26 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt b/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
> index c84bc027930b..597397a048f8 100644
> --- a/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
> +++ b/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
> @@ -33,6 +33,7 @@ Required properties
> "bus": bus reset.
>
> Optional properties:
> +- power-gpios: The gpio to control the power of PCIe slot.
> - reset-gpios: The gpio to generate PCIe PERST# assert and deassert signal.
> - phys: List of phandle and phy mode specifier, should be 0.
> - phy-names: Must be "phy".
> diff --git a/drivers/pci/dwc/pcie-histb.c b/drivers/pci/dwc/pcie-histb.c
> index 33b01b734d7d..2a6b18619b25 100644
> --- a/drivers/pci/dwc/pcie-histb.c
> +++ b/drivers/pci/dwc/pcie-histb.c
> @@ -63,6 +63,7 @@ struct histb_pcie {
> struct reset_control *sys_reset;
> struct reset_control *bus_reset;
> void __iomem *ctrl;
> + int power_gpio;
> int reset_gpio;
> };
>
> @@ -230,6 +231,8 @@ static void histb_pcie_host_disable(struct histb_pcie *hipcie)
>
> if (gpio_is_valid(hipcie->reset_gpio))
> gpio_set_value_cansleep(hipcie->reset_gpio, 0);
> + if (gpio_is_valid(hipcie->power_gpio))
> + gpio_set_value_cansleep(hipcie->power_gpio, 0);
> }
>
> static int histb_pcie_host_enable(struct pcie_port *pp)
> @@ -240,8 +243,14 @@ static int histb_pcie_host_enable(struct pcie_port *pp)
> int ret;
>
> /* power on PCIe device if have */
> - if (gpio_is_valid(hipcie->reset_gpio))
> + if (gpio_is_valid(hipcie->power_gpio))
> + gpio_set_value_cansleep(hipcie->power_gpio, 1);
> +
> + if (gpio_is_valid(hipcie->reset_gpio)) {
> + gpio_set_value_cansleep(hipcie->reset_gpio, 0);
> + mdelay(10);
> gpio_set_value_cansleep(hipcie->reset_gpio, 1);
> + }
>
> ret = clk_prepare_enable(hipcie->bus_clk);
> if (ret) {
> @@ -335,15 +344,28 @@ static int histb_pcie_probe(struct platform_device *pdev)
> return PTR_ERR(pci->dbi_base);
> }
>
> + hipcie->power_gpio = of_get_named_gpio_flags(np,
> + "power-gpios", 0, &of_flags);
> + if (of_flags & OF_GPIO_ACTIVE_LOW)
> + flag |= GPIOF_ACTIVE_LOW;
Why isn't this inside the if statement?
> + if (gpio_is_valid(hipcie->power_gpio)) {
> + ret = devm_gpio_request_one(dev, hipcie->power_gpio,
> + flag, "PCIe device power control");
> + if (ret) {
> + dev_err(dev, "unable to request power gpio\n");
> + return ret;
> + }
> + }
> +
> hipcie->reset_gpio = of_get_named_gpio_flags(np,
> "reset-gpios", 0, &of_flags);
> if (of_flags & OF_GPIO_ACTIVE_LOW)
> flag |= GPIOF_ACTIVE_LOW;
> if (gpio_is_valid(hipcie->reset_gpio)) {
> ret = devm_gpio_request_one(dev, hipcie->reset_gpio,
> - flag, "PCIe device power control");
> + flag, "PCIe device reset control");
> if (ret) {
> - dev_err(dev, "unable to request gpio\n");
> + dev_err(dev, "unable to request reset gpio\n");
> return ret;
> }
> }
> --
> 1.9.1
>
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [project-aspen-dev] [PATCH] PCI: histb: add power control GPIO for PCIe slot
[not found] ` <20180123093944.rxysbjm2u6suycco-Xg7FH8f/bVM@public.gmane.org>
@ 2018-01-23 10:52 ` Shawn Guo
0 siblings, 0 replies; 7+ messages in thread
From: Shawn Guo @ 2018-01-23 10:52 UTC (permalink / raw)
To: Daniel Thompson
Cc: Bjorn Helgaas, Rob Herring, linux-pci-u79uwXL29TY76Z2rM5mHXA,
devicetree-u79uwXL29TY76Z2rM5mHXA,
project-aspen-dev-QSEj5FYQhm4dnm+yROfE0A, Jianguo Sun
Hi Daniel,
On Tue, Jan 23, 2018 at 09:39:44AM +0000, Daniel Thompson wrote:
> > @@ -335,15 +344,28 @@ static int histb_pcie_probe(struct platform_device *pdev)
> > return PTR_ERR(pci->dbi_base);
> > }
> >
> > + hipcie->power_gpio = of_get_named_gpio_flags(np,
> > + "power-gpios", 0, &of_flags);
> > + if (of_flags & OF_GPIO_ACTIVE_LOW)
> > + flag |= GPIOF_ACTIVE_LOW;
>
> Why isn't this inside the if statement?
Are you asking why the flag manipulation is not in the gpio_is_valid()
if-clause below?
I guess this is a copy of how reset_gpio is handled. It might be a bit
more sensible to check the validity of the GPIO before handling the
flag, but practically the current code doesn't really hurt too much.
I will take Fabio's suggestion to reimplement it with a fixed regulator.
But thanks for the comment anyway.
Shawn
> > + if (gpio_is_valid(hipcie->power_gpio)) {
> > + ret = devm_gpio_request_one(dev, hipcie->power_gpio,
> > + flag, "PCIe device power control");
> > + if (ret) {
> > + dev_err(dev, "unable to request power gpio\n");
> > + return ret;
> > + }
> > + }
> > +
> > hipcie->reset_gpio = of_get_named_gpio_flags(np,
> > "reset-gpios", 0, &of_flags);
> > if (of_flags & OF_GPIO_ACTIVE_LOW)
> > flag |= GPIOF_ACTIVE_LOW;
> > if (gpio_is_valid(hipcie->reset_gpio)) {
> > ret = devm_gpio_request_one(dev, hipcie->reset_gpio,
> > - flag, "PCIe device power control");
> > + flag, "PCIe device reset control");
> > if (ret) {
> > - dev_err(dev, "unable to request gpio\n");
> > + dev_err(dev, "unable to request reset gpio\n");
> > return ret;
> > }
> > }
> > --
> > 1.9.1
> >
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH] PCI: histb: add power control GPIO for PCIe slot
2018-01-23 1:12 ` Fabio Estevam
@ 2018-01-23 10:54 ` Shawn Guo
0 siblings, 0 replies; 7+ messages in thread
From: Shawn Guo @ 2018-01-23 10:54 UTC (permalink / raw)
To: Fabio Estevam
Cc: Bjorn Helgaas, Rob Herring, linux-pci,
open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS,
project-aspen-dev, Jianguo Sun
On Mon, Jan 22, 2018 at 11:12:44PM -0200, Fabio Estevam wrote:
> Hi Shawn,
>
> On Mon, Jan 22, 2018 at 11:04 PM, Shawn Guo <shawn.guo@linaro.org> wrote:
> > From: Jianguo Sun <sunjianguo1@huawei.com>
> >
> > Besides the GPIO for controlling reset, there is also possibly another
> > GPIO for turning on/off the power of PCIe slot. Let's add the support
> > for that with another optional device tree property 'power-gpios'.
>
> It seems that a better approach would be to add regulator support
> instead as it is more general.
It's a sensible suggestion. I will take it in v2. Thanks, Fabio.
Shawn
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH] PCI: histb: add power control GPIO for PCIe slot
2018-01-23 1:04 [PATCH] PCI: histb: add power control GPIO for PCIe slot Shawn Guo
2018-01-23 1:12 ` Fabio Estevam
[not found] ` <1516669477-20151-1-git-send-email-shawn.guo-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org>
@ 2018-03-02 12:10 ` Lorenzo Pieralisi
2018-03-02 12:36 ` Shawn Guo
2 siblings, 1 reply; 7+ messages in thread
From: Lorenzo Pieralisi @ 2018-03-02 12:10 UTC (permalink / raw)
To: Shawn Guo
Cc: Bjorn Helgaas, Rob Herring, linux-pci, devicetree,
project-aspen-dev, Jianguo Sun
Hi Shawn,
On Tue, Jan 23, 2018 at 09:04:37AM +0800, Shawn Guo wrote:
> From: Jianguo Sun <sunjianguo1@huawei.com>
>
> Besides the GPIO for controlling reset, there is also possibly another
> GPIO for turning on/off the power of PCIe slot. Let's add the support
> for that with another optional device tree property 'power-gpios'.
>
> Signed-off-by: Jianguo Sun <sunjianguo1@huawei.com>
> Signed-off-by: Shawn Guo <shawn.guo@linaro.org>
> ---
> .../bindings/pci/hisilicon-histb-pcie.txt | 1 +
> drivers/pci/dwc/pcie-histb.c | 28 +++++++++++++++++++---
Is there a dependency between this patch and this series:
https://patchwork.ozlabs.org/project/linux-pci/list/?series=31410
It does not look like, I'd apply the series but I wanted to ask
first.
This patch misses Rob's ACK.
Thanks,
Lorenzo
> 2 files changed, 26 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt b/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
> index c84bc027930b..597397a048f8 100644
> --- a/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
> +++ b/Documentation/devicetree/bindings/pci/hisilicon-histb-pcie.txt
> @@ -33,6 +33,7 @@ Required properties
> "bus": bus reset.
>
> Optional properties:
> +- power-gpios: The gpio to control the power of PCIe slot.
> - reset-gpios: The gpio to generate PCIe PERST# assert and deassert signal.
> - phys: List of phandle and phy mode specifier, should be 0.
> - phy-names: Must be "phy".
> diff --git a/drivers/pci/dwc/pcie-histb.c b/drivers/pci/dwc/pcie-histb.c
> index 33b01b734d7d..2a6b18619b25 100644
> --- a/drivers/pci/dwc/pcie-histb.c
> +++ b/drivers/pci/dwc/pcie-histb.c
> @@ -63,6 +63,7 @@ struct histb_pcie {
> struct reset_control *sys_reset;
> struct reset_control *bus_reset;
> void __iomem *ctrl;
> + int power_gpio;
> int reset_gpio;
> };
>
> @@ -230,6 +231,8 @@ static void histb_pcie_host_disable(struct histb_pcie *hipcie)
>
> if (gpio_is_valid(hipcie->reset_gpio))
> gpio_set_value_cansleep(hipcie->reset_gpio, 0);
> + if (gpio_is_valid(hipcie->power_gpio))
> + gpio_set_value_cansleep(hipcie->power_gpio, 0);
> }
>
> static int histb_pcie_host_enable(struct pcie_port *pp)
> @@ -240,8 +243,14 @@ static int histb_pcie_host_enable(struct pcie_port *pp)
> int ret;
>
> /* power on PCIe device if have */
> - if (gpio_is_valid(hipcie->reset_gpio))
> + if (gpio_is_valid(hipcie->power_gpio))
> + gpio_set_value_cansleep(hipcie->power_gpio, 1);
> +
> + if (gpio_is_valid(hipcie->reset_gpio)) {
> + gpio_set_value_cansleep(hipcie->reset_gpio, 0);
> + mdelay(10);
> gpio_set_value_cansleep(hipcie->reset_gpio, 1);
> + }
>
> ret = clk_prepare_enable(hipcie->bus_clk);
> if (ret) {
> @@ -335,15 +344,28 @@ static int histb_pcie_probe(struct platform_device *pdev)
> return PTR_ERR(pci->dbi_base);
> }
>
> + hipcie->power_gpio = of_get_named_gpio_flags(np,
> + "power-gpios", 0, &of_flags);
> + if (of_flags & OF_GPIO_ACTIVE_LOW)
> + flag |= GPIOF_ACTIVE_LOW;
> + if (gpio_is_valid(hipcie->power_gpio)) {
> + ret = devm_gpio_request_one(dev, hipcie->power_gpio,
> + flag, "PCIe device power control");
> + if (ret) {
> + dev_err(dev, "unable to request power gpio\n");
> + return ret;
> + }
> + }
> +
> hipcie->reset_gpio = of_get_named_gpio_flags(np,
> "reset-gpios", 0, &of_flags);
> if (of_flags & OF_GPIO_ACTIVE_LOW)
> flag |= GPIOF_ACTIVE_LOW;
> if (gpio_is_valid(hipcie->reset_gpio)) {
> ret = devm_gpio_request_one(dev, hipcie->reset_gpio,
> - flag, "PCIe device power control");
> + flag, "PCIe device reset control");
> if (ret) {
> - dev_err(dev, "unable to request gpio\n");
> + dev_err(dev, "unable to request reset gpio\n");
> return ret;
> }
> }
> --
> 1.9.1
>
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH] PCI: histb: add power control GPIO for PCIe slot
2018-03-02 12:10 ` Lorenzo Pieralisi
@ 2018-03-02 12:36 ` Shawn Guo
0 siblings, 0 replies; 7+ messages in thread
From: Shawn Guo @ 2018-03-02 12:36 UTC (permalink / raw)
To: Lorenzo Pieralisi
Cc: Bjorn Helgaas, Rob Herring, linux-pci, devicetree,
project-aspen-dev, Jianguo Sun
Hi Lorenzo,
On Fri, Mar 02, 2018 at 12:10:00PM +0000, Lorenzo Pieralisi wrote:
> Hi Shawn,
>
> On Tue, Jan 23, 2018 at 09:04:37AM +0800, Shawn Guo wrote:
> > From: Jianguo Sun <sunjianguo1@huawei.com>
> >
> > Besides the GPIO for controlling reset, there is also possibly another
> > GPIO for turning on/off the power of PCIe slot. Let's add the support
> > for that with another optional device tree property 'power-gpios'.
> >
> > Signed-off-by: Jianguo Sun <sunjianguo1@huawei.com>
> > Signed-off-by: Shawn Guo <shawn.guo@linaro.org>
> > ---
> > .../bindings/pci/hisilicon-histb-pcie.txt | 1 +
> > drivers/pci/dwc/pcie-histb.c | 28 +++++++++++++++++++---
>
> Is there a dependency between this patch and this series:
>
> https://patchwork.ozlabs.org/project/linux-pci/list/?series=31410
>
> It does not look like, I'd apply the series but I wanted to ask
> first.
This is the v1 of the same series. Please ignore this one, and only
review the latest v3. Sorry for the confusion.
Shawn
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2018-03-02 12:36 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2018-01-23 1:04 [PATCH] PCI: histb: add power control GPIO for PCIe slot Shawn Guo
2018-01-23 1:12 ` Fabio Estevam
2018-01-23 10:54 ` Shawn Guo
[not found] ` <1516669477-20151-1-git-send-email-shawn.guo-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org>
2018-01-23 9:39 ` [project-aspen-dev] " Daniel Thompson
[not found] ` <20180123093944.rxysbjm2u6suycco-Xg7FH8f/bVM@public.gmane.org>
2018-01-23 10:52 ` Shawn Guo
2018-03-02 12:10 ` Lorenzo Pieralisi
2018-03-02 12:36 ` Shawn Guo
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).