PCI: endpoint: pci-epf-test: Call
Subsystems (2)
v3 cover PCI: endpoint: pci-epf-test: Call
Hello,
I added a cover letter to keep track of the changes between versions. I feel the v3 is clear and clean.
Best regards,
Rick
Changes from v2:
- Removed duplicated code and simplified the patch.
https://lore.kernel.org/linux-pci/[email protected]/
Changes from v1:
- Clarified the commit message.
- Clarified the error message in endpoint.
https://lore.kernel.org/linux-pci/[email protected]/
Rick Wertenbroek (1):
PCI: endpoint: pci-epf-test: Call pci_epf_test_raise_irq() on failed
DMA check
drivers/pci/endpoint/functions/pci-epf-test.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
Signature · 1 line
2.25.1
PATCH v3 1/1 PCI: endpoint: pci-epf-test: Call pci_epf_test_raise_irq() on failed DMA check
The pci-epf-test PCI endpoint function /drivers/pci/endpoint/function/pci-epf_test.c is meant to be used in a PCI endpoint device connected to a host computer with the host side driver: /drivers/misc/pci_endpoint_test.c.
The host side driver can request read/write/copy transactions from the endpoint function and expects an IRQ from the endpoint function once the read/write/copy transaction is finished. These can be issued with or without DMA enabled. If the host side driver requests a read/write/copy transaction with DMA enabled and the endpoint function does not support DMA, the endpoint would only print an error message and wait for further commands without sending an IRQ because pci_epf_test_raise_irq() is skipped in pci_epf_test_cmd_handler(). This results in the host side driver hanging indefinitely waiting for the IRQ.
Call pci_epf_test_raise_irq() when a transfer with DMA is requested but DMA is unsupported. The host side driver will no longer hang but report an error on transfer (printing "NOT OKAY") thanks to the checksum because no data was moved.
Clarify the error message in the endpoint function as "Cannot ..." is vague and does not state the reason why it cannot be done.
--- drivers/pci/endpoint/functions/pci-epf-test.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
drivers/pci/endpoint/functions/pci-epf-test.c +2 -1
@@ -649,7 +649,8 @@ static void pci_epf_test_cmd_handler(struct work_struct *work)if ((READ_ONCE (reg->flags) &FLAG_USE_DMA ) && !epf_test->dma_supported) { -dev_err (dev,"Cannot transfer data using DMA\n" ); +dev_err (dev,"DMA transfer not supported\n" ); +pci_epf_test_raise_irq (epf_test, reg); goto reset_handler; }
Signature · 1 line
2.25.1
Re: [PATCH v3 1/1] PCI: endpoint: pci-epf-test: Call pci_epf_test_raise_irq() on failed DMA check
Quoted 32 lines · Rick Wertenbroek
The pci-epf-test PCI endpoint function /drivers/pci/endpoint/function/pci-epf_test.c is meant to be used in a PCI endpoint device connected to a host computer with the host side driver: /drivers/misc/pci_endpoint_test.c.
The host side driver can request read/write/copy transactions from the endpoint function and expects an IRQ from the endpoint function once the read/write/copy transaction is finished. These can be issued with or without DMA enabled. If the host side driver requests a read/write/copy transaction with DMA enabled and the endpoint function does not support DMA, the endpoint would only print an error message and wait for further commands without sending an IRQ because
pci_epf_test_raise_irq()is skipped inpci_epf_test_cmd_handler(). This results in the host side driver hanging indefinitely waiting for the IRQ.Call
pci_epf_test_raise_irq()when a transfer with DMA is requested but DMA is unsupported. The host side driver will no longer hang but report an error on transfer (printing "NOT OKAY") thanks to the checksum because no data was moved.Clarify the error message in the endpoint function as "Cannot ..." is vague and does not state the reason why it cannot be done.
Signed-off-by Rick Wertenbroek <[email protected]>--- drivers/pci/endpoint/functions/pci-epf-test.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)drivers/pci/endpoint/functions/pci-epf-test.c +0
-0
drivers/pci/endpoint/functions/pci-epf-test.c static void pci_epf_test_cmd_handler(struct work_struct *work) · line 652
Quoted 5 lines
drivers/pci/endpoint/functions/pci-epf-test.c +1
-1@@ -649,7 +649,8 @@ static void pci_epf_test_cmd_handler(struct work_struct *work)if ((READ_ONCE (reg->flags) &FLAG_USE_DMA ) && !epf_test->dma_supported) { -dev_err (dev,"Cannot transfer data using DMA\n" ); +dev_err (dev,"DMA transfer not supported\n" );
Should we set the FAIL status flag here ?
E.g.:
reg->status |= STATUS_READ_FAIL;
Note: I have no idea why the status flags are different for the different operations. We should really have a single SUCCESS/FAIL flag common to all operations. So I think we could just do:
reg->status |= STATUS_READ_FAIL | STATUS_WRITE_FAIL | STATUS_COPY_FAIL;
here, or go back to your v1 and handle the failure in each operation function to set the correct flag.
Quoted 4 lines
drivers/pci/endpoint/functions/pci-epf-test.c +1
-0+pci_epf_test_raise_irq (epf_test, reg); goto reset_handler; }
Signature · 2 lines
Damien Le Moal Western Digital Research
Re: [PATCH v3 1/1] PCI: endpoint: pci-epf-test: Call pci_epf_test_raise_irq() on failed DMA check
Quoted 48 lines · Damien Le Moal
Quoted 32 lines · Rick Wertenbroek
The pci-epf-test PCI endpoint function /drivers/pci/endpoint/function/pci-epf_test.c is meant to be used in a PCI endpoint device connected to a host computer with the host side driver: /drivers/misc/pci_endpoint_test.c.
The host side driver can request read/write/copy transactions from the endpoint function and expects an IRQ from the endpoint function once the read/write/copy transaction is finished. These can be issued with or without DMA enabled. If the host side driver requests a read/write/copy transaction with DMA enabled and the endpoint function does not support DMA, the endpoint would only print an error message and wait for further commands without sending an IRQ because
pci_epf_test_raise_irq()is skipped inpci_epf_test_cmd_handler(). This results in the host side driver hanging indefinitely waiting for the IRQ.Call
pci_epf_test_raise_irq()when a transfer with DMA is requested but DMA is unsupported. The host side driver will no longer hang but report an error on transfer (printing "NOT OKAY") thanks to the checksum because no data was moved.Clarify the error message in the endpoint function as "Cannot ..." is vague and does not state the reason why it cannot be done.
Signed-off-by Rick Wertenbroek <[email protected]>--- drivers/pci/endpoint/functions/pci-epf-test.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)drivers/pci/endpoint/functions/pci-epf-test.c +0
-0drivers/pci/endpoint/functions/pci-epf-test.c static void pci_epf_test_cmd_handler(struct work_struct *work) · line 652
Quoted 5 lines
drivers/pci/endpoint/functions/pci-epf-test.c +1
-1@@ -649,7 +649,8 @@ static void pci_epf_test_cmd_handler(struct work_struct *work)if ((READ_ONCE (reg->flags) &FLAG_USE_DMA ) && !epf_test->dma_supported) { -dev_err (dev,"Cannot transfer data using DMA\n" ); +dev_err (dev,"DMA transfer not supported\n" );Should we set the FAIL status flag here ?
E.g.:reg->status |= STATUS_READ_FAIL;Note: I have no idea why the status flags are different for the different operations. We should really have a single SUCCESS/FAIL flag common to all operations. So I think we could just do:
Quoted 6 lines
reg->status |= STATUS_READ_FAIL | STATUS_WRITE_FAIL | STATUS_COPY_FAIL;here, or go back to your v1 and handle the failure in each operation function to set the correct flag.
Good catch, indeed with the check outside of the functions, the status FAIL bits are not set. I think setting the status as a combined fail flag makes sense, however, it conveys the idea that read/write/copy failed whereas only one of them actually failed.
I agree that a single status SUCCESS/FAIL flag would be simpler. But changing this would require changes on both sides (EP & RC) and will reduce compatibility between EP and RC side driver versions, so I would refrain from changing this.
I think I still prefer the v1/v2 code because even as it has a little
bit of duplication it is clear and sets the correct FAIL bit without extra logic whereas here we either set all FAIL bits or have to add extra logic.
Thank you for spotting this.
Quoted 9 lines
drivers/pci/endpoint/functions/pci-epf-test.c static void pci_epf_test_cmd_handler(struct work_struct *work) · line 656
Quoted 4 lines
drivers/pci/endpoint/functions/pci-epf-test.c +1
-0+pci_epf_test_raise_irq (epf_test, reg); goto reset_handler; }--
Damien Le Moal
Western Digital Research
Best regards,
Rick
Re: [PATCH v3 1/1] PCI: endpoint: pci-epf-test: Call pci_epf_test_raise_irq() on failed DMA check
Quoted 66 lines · Rick Wertenbroek
Quoted 48 lines · Damien Le Moal
Quoted 32 lines · Rick Wertenbroek
The pci-epf-test PCI endpoint function /drivers/pci/endpoint/function/pci-epf_test.c is meant to be used in a PCI endpoint device connected to a host computer with the host side driver: /drivers/misc/pci_endpoint_test.c.
The host side driver can request read/write/copy transactions from the endpoint function and expects an IRQ from the endpoint function once the read/write/copy transaction is finished. These can be issued with or without DMA enabled. If the host side driver requests a read/write/copy transaction with DMA enabled and the endpoint function does not support DMA, the endpoint would only print an error message and wait for further commands without sending an IRQ because
pci_epf_test_raise_irq()is skipped inpci_epf_test_cmd_handler(). This results in the host side driver hanging indefinitely waiting for the IRQ.Call
pci_epf_test_raise_irq()when a transfer with DMA is requested but DMA is unsupported. The host side driver will no longer hang but report an error on transfer (printing "NOT OKAY") thanks to the checksum because no data was moved.Clarify the error message in the endpoint function as "Cannot ..." is vague and does not state the reason why it cannot be done.
Signed-off-by Rick Wertenbroek <[email protected]>--- drivers/pci/endpoint/functions/pci-epf-test.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)drivers/pci/endpoint/functions/pci-epf-test.c +0
-0drivers/pci/endpoint/functions/pci-epf-test.c static void pci_epf_test_cmd_handler(struct work_struct *work) · line 652
Quoted 5 lines
drivers/pci/endpoint/functions/pci-epf-test.c +1
-1@@ -649,7 +649,8 @@ static void pci_epf_test_cmd_handler(struct work_struct *work)if ((READ_ONCE (reg->flags) &FLAG_USE_DMA ) && !epf_test->dma_supported) { -dev_err (dev,"Cannot transfer data using DMA\n" ); +dev_err (dev,"DMA transfer not supported\n" );Should we set the FAIL status flag here ?
E.g.:reg->status |= STATUS_READ_FAIL;Note: I have no idea why the status flags are different for the different operations. We should really have a single SUCCESS/FAIL flag common to all operations. So I think we could just do:
Quoted 6 lines
reg->status |= STATUS_READ_FAIL | STATUS_WRITE_FAIL | STATUS_COPY_FAIL;here, or go back to your v1 and handle the failure in each operation function to set the correct flag.
Good catch, indeed with the check outside of the functions, the status FAIL bits are not set. I think setting the status as a combined fail flag makes sense, however, it conveys the idea that read/write/copy failed whereas only one of them actually failed.
I agree that a single status SUCCESS/FAIL flag would be simpler. But changing this would require changes on both sides (EP & RC) and will reduce compatibility between EP and RC side driver versions, so I would refrain from changing this.
Quoted 6 lines
I think I still prefer the v1/v2 code because even as it has a little
bit of duplication it is clear and sets the correct FAIL bit without extra logic whereas here we either set all FAIL bits or have to add extra logic.Thank you for spotting this.
Agree, v1 is cleaner in that respect, despite the duplicated checks. So my review tag stands :)
Mani ? Thoughts ?
Quoted 13 lines
Quoted 10 lines
drivers/pci/endpoint/functions/pci-epf-test.c static void pci_epf_test_cmd_handler(struct work_struct *work) · line 656
Quoted 5 lines
drivers/pci/endpoint/functions/pci-epf-test.c +1
-0+pci_epf_test_raise_irq (epf_test, reg); goto reset_handler; }--
Damien Le Moal
Western Digital ResearchBest regards,
Rick
Signature · 2 lines
Damien Le Moal Western Digital Research
Re: [PATCH v3 1/1] PCI: endpoint: pci-epf-test: Call pci_epf_test_raise_irq() on failed DMA check
In reply to Rick WertenbroekQuoted 61 lines · Rick Wertenbroek
Quoted 48 lines · Damien Le Moal
Quoted 32 lines · Rick Wertenbroek
The pci-epf-test PCI endpoint function /drivers/pci/endpoint/function/pci-epf_test.c is meant to be used in a PCI endpoint device connected to a host computer with the host side driver: /drivers/misc/pci_endpoint_test.c.
The host side driver can request read/write/copy transactions from the endpoint function and expects an IRQ from the endpoint function once the read/write/copy transaction is finished. These can be issued with or without DMA enabled. If the host side driver requests a read/write/copy transaction with DMA enabled and the endpoint function does not support DMA, the endpoint would only print an error message and wait for further commands without sending an IRQ because
pci_epf_test_raise_irq()is skipped inpci_epf_test_cmd_handler(). This results in the host side driver hanging indefinitely waiting for the IRQ.Call
pci_epf_test_raise_irq()when a transfer with DMA is requested but DMA is unsupported. The host side driver will no longer hang but report an error on transfer (printing "NOT OKAY") thanks to the checksum because no data was moved.Clarify the error message in the endpoint function as "Cannot ..." is vague and does not state the reason why it cannot be done.
Signed-off-by Rick Wertenbroek <[email protected]>--- drivers/pci/endpoint/functions/pci-epf-test.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)drivers/pci/endpoint/functions/pci-epf-test.c +0
-0drivers/pci/endpoint/functions/pci-epf-test.c static void pci_epf_test_cmd_handler(struct work_struct *work) · line 652
Quoted 5 lines
drivers/pci/endpoint/functions/pci-epf-test.c +1
-1@@ -649,7 +649,8 @@ static void pci_epf_test_cmd_handler(struct work_struct *work)if ((READ_ONCE (reg->flags) &FLAG_USE_DMA ) && !epf_test->dma_supported) { -dev_err (dev,"Cannot transfer data using DMA\n" ); +dev_err (dev,"DMA transfer not supported\n" );Should we set the FAIL status flag here ?
E.g.:reg->status |= STATUS_READ_FAIL;Note: I have no idea why the status flags are different for the different operations. We should really have a single SUCCESS/FAIL flag common to all operations. So I think we could just do:
Quoted 6 lines
reg->status |= STATUS_READ_FAIL | STATUS_WRITE_FAIL | STATUS_COPY_FAIL;here, or go back to your v1 and handle the failure in each operation function to set the correct flag.
Good catch, indeed with the check outside of the functions, the status FAIL bits are not set. I think setting the status as a combined fail flag makes sense, however, it conveys the idea that read/write/copy failed whereas only one of them actually failed.
Quoted 5 lines
I agree that a single status SUCCESS/FAIL flag would be simpler. But changing this would require changes on both sides (EP & RC) and will reduce compatibility between EP and RC side driver versions, so I would refrain from changing this.
I think it is OK to change the status flags and do the right thing. If someone reports a test failure, then we can ask them to upgrade their kernel. Given that this this just a test application, I don't think it is a big deal.
- Mani
Quoted 19 lines
I think I still prefer the v1/v2 code because even as it has a little
bit of duplication it is clear and sets the correct FAIL bit without extra logic whereas here we either set all FAIL bits or have to add extra logic.Thank you for spotting this.
Quoted 9 lines
drivers/pci/endpoint/functions/pci-epf-test.c static void pci_epf_test_cmd_handler(struct work_struct *work) · line 656
Quoted 4 lines
drivers/pci/endpoint/functions/pci-epf-test.c +1
-0+pci_epf_test_raise_irq (epf_test, reg); goto reset_handler; }--
Damien Le Moal
Western Digital ResearchBest regards,
Rick
Signature · 1 line
மணிவண்ணன் சதாசிவம்