* [PATCH] PCI: Document PCIE BUS MPS parameters @ 2013-01-23 8:01 Yijing Wang 2013-01-23 9:21 ` Andrew Murray 0 siblings, 1 reply; 5+ messages in thread From: Yijing Wang @ 2013-01-23 8:01 UTC (permalink / raw) To: Rob Landley, Bjorn Helgaas Cc: linux-doc, linux-kernel, Jon Mason, linux-pci, Hanjun Guo, jiang.liu, Yijing Wang Document PCIE BUS MPS parameters pcie_bus_tune_off, pcie_bus_safe, pcie_bus_peer2peer, pcie_bus_perf into Documentation/kernel-parameters.txt. These parameters were introduced by Jon Mason <mason@myri.com> at commit 5f39e6705 and commit b03e7495a8. Document these into kernel-parameters.txt help users to understand and use the parameters. Signed-off-by: Yijing Wang <wangyijing@huawei.com> --- Documentation/kernel-parameters.txt | 13 +++++++++++++ 1 files changed, 13 insertions(+), 0 deletions(-) diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt index 363e348..4dfa8d2 100644 --- a/Documentation/kernel-parameters.txt +++ b/Documentation/kernel-parameters.txt @@ -2227,6 +2227,19 @@ bytes respectively. Such letter suffixes can also be entirely omitted. This sorting is done to get a device order compatible with older (<= 2.4) kernels. nobfsort Don't sort PCI devices into breadth-first order. + pcie_bus_tune_off [X86] Disable PCI-E MPS turning and using + the BIOS configured MPS defaults. + pcie_bus_safe [X86] Use the smallest common denominator MPS + of the entire tree below a root complex for every device + on that fabric. Can avoid inconsistent mps problem caused + by hotplug. + pcie_bus_perf [X86] Configure pcie device MPS to the largest + allowable MPS based on its parent bus.Improve performance + as much as possible. + pcie_bus_peer2peer [X86] Make the system wide MPS the smallest + possible value (128B).This configuration could prevent it + from working by having the MPS on one root port different + than the MPS on another. cbiosize=nn[KMG] The fixed amount of bus space which is reserved for the CardBus bridge's IO window. The default value is 256 bytes. -- 1.7.1 ^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH] PCI: Document PCIE BUS MPS parameters 2013-01-23 8:01 [PATCH] PCI: Document PCIE BUS MPS parameters Yijing Wang @ 2013-01-23 9:21 ` Andrew Murray 2013-01-23 10:13 ` Yijing Wang 0 siblings, 1 reply; 5+ messages in thread From: Andrew Murray @ 2013-01-23 9:21 UTC (permalink / raw) To: Yijing Wang Cc: Rob Landley, Bjorn Helgaas, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jon Mason, linux-pci@vger.kernel.org, Hanjun Guo, jiang.liu@huawei.com On Wed, Jan 23, 2013 at 08:01:36AM +0000, Yijing Wang wrote: > Document PCIE BUS MPS parameters pcie_bus_tune_off, pcie_bus_safe, > pcie_bus_peer2peer, pcie_bus_perf into Documentation/kernel-parameters.txt. > These parameters were introduced by Jon Mason <mason@myri.com> at > commit 5f39e6705 and commit b03e7495a8. Document these into > kernel-parameters.txt help users to understand and use the parameters. > > Signed-off-by: Yijing Wang <wangyijing@huawei.com> > --- > Documentation/kernel-parameters.txt | 13 +++++++++++++ > 1 files changed, 13 insertions(+), 0 deletions(-) > > diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt > index 363e348..4dfa8d2 100644 > --- a/Documentation/kernel-parameters.txt > +++ b/Documentation/kernel-parameters.txt > @@ -2227,6 +2227,19 @@ bytes respectively. Such letter suffixes can also be entirely omitted. > This sorting is done to get a device > order compatible with older (<= 2.4) kernels. > nobfsort Don't sort PCI devices into breadth-first order. > + pcie_bus_tune_off [X86] Disable PCI-E MPS turning and using > + the BIOS configured MPS defaults. > + pcie_bus_safe [X86] Use the smallest common denominator MPS > + of the entire tree below a root complex for every device > + on that fabric. Can avoid inconsistent mps problem caused > + by hotplug. > + pcie_bus_perf [X86] Configure pcie device MPS to the largest > + allowable MPS based on its parent bus.Improve performance > + as much as possible. > + pcie_bus_peer2peer [X86] Make the system wide MPS the smallest > + possible value (128B).This configuration could prevent it > + from working by having the MPS on one root port different > + than the MPS on another. > cbiosize=nn[KMG] The fixed amount of bus space which is > reserved for the CardBus bridge's IO window. > The default value is 256 bytes. > I was searching for documentation on this the other day. It's not just X86 that use these options, PowerPC and Tile also use them (grep for users of pcie_bus_configure_settings). I've also noticed a call to it from hotplug as well... In addition these options also have an effect on MRRS - I've not figured out what effect they have, but you can look in drivers/pci/probe.c at the pcie_write_mrrs function. Andrew Murray ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] PCI: Document PCIE BUS MPS parameters 2013-01-23 9:21 ` Andrew Murray @ 2013-01-23 10:13 ` Yijing Wang 2013-01-23 10:30 ` Andrew Murray 0 siblings, 1 reply; 5+ messages in thread From: Yijing Wang @ 2013-01-23 10:13 UTC (permalink / raw) To: Andrew Murray Cc: Yijing Wang, Rob Landley, Bjorn Helgaas, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jon Mason, linux-pci@vger.kernel.org, Hanjun Guo, jiang.liu@huawei.com 于 2013-01-23 17:21, Andrew Murray 写道: > On Wed, Jan 23, 2013 at 08:01:36AM +0000, Yijing Wang wrote: >> Document PCIE BUS MPS parameters pcie_bus_tune_off, pcie_bus_safe, >> pcie_bus_peer2peer, pcie_bus_perf into Documentation/kernel-parameters.txt. >> These parameters were introduced by Jon Mason <mason@myri.com> at >> commit 5f39e6705 and commit b03e7495a8. Document these into >> kernel-parameters.txt help users to understand and use the parameters. >> >> Signed-off-by: Yijing Wang <wangyijing@huawei.com> >> --- >> Documentation/kernel-parameters.txt | 13 +++++++++++++ >> 1 files changed, 13 insertions(+), 0 deletions(-) >> >> diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt >> index 363e348..4dfa8d2 100644 >> --- a/Documentation/kernel-parameters.txt >> +++ b/Documentation/kernel-parameters.txt >> @@ -2227,6 +2227,19 @@ bytes respectively. Such letter suffixes can also be entirely omitted. >> This sorting is done to get a device >> order compatible with older (<= 2.4) kernels. >> nobfsort Don't sort PCI devices into breadth-first order. >> + pcie_bus_tune_off [X86] Disable PCI-E MPS turning and using >> + the BIOS configured MPS defaults. >> + pcie_bus_safe [X86] Use the smallest common denominator MPS >> + of the entire tree below a root complex for every device >> + on that fabric. Can avoid inconsistent mps problem caused >> + by hotplug. >> + pcie_bus_perf [X86] Configure pcie device MPS to the largest >> + allowable MPS based on its parent bus.Improve performance >> + as much as possible. >> + pcie_bus_peer2peer [X86] Make the system wide MPS the smallest >> + possible value (128B).This configuration could prevent it >> + from working by having the MPS on one root port different >> + than the MPS on another. >> cbiosize=nn[KMG] The fixed amount of bus space which is >> reserved for the CardBus bridge's IO window. >> The default value is 256 bytes. >> > I was searching for documentation on this the other day. > > It's not just X86 that use these options, PowerPC and Tile also use them (grep > for users of pcie_bus_configure_settings). I've also noticed a call to it from > hotplug as well... Hi Andrew, Thanks for reminder! I will update this patch right now. > > In addition these options also have an effect on MRRS - I've not figured out > what effect they have, but you can look in drivers/pci/probe.c at the > pcie_write_mrrs function. This is a separate issue, Andrew, can you provide the effetct problem log or detail information? That will helps us to analyze this issue. > > Andrew Murray > > > -- > To unsubscribe from this list: send the line "unsubscribe linux-pci" in > the body of a message to majordomo@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html > ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] PCI: Document PCIE BUS MPS parameters 2013-01-23 10:13 ` Yijing Wang @ 2013-01-23 10:30 ` Andrew Murray 2013-01-23 11:44 ` Yijing Wang 0 siblings, 1 reply; 5+ messages in thread From: Andrew Murray @ 2013-01-23 10:30 UTC (permalink / raw) To: Yijing Wang Cc: Yijing Wang, Rob Landley, Bjorn Helgaas, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jon Mason, linux-pci@vger.kernel.org, Hanjun Guo, jiang.liu@huawei.com On Wed, Jan 23, 2013 at 10:13:02AM +0000, Yijing Wang wrote: > ??? 2013-01-23 17:21, Andrew Murray ??????: > > On Wed, Jan 23, 2013 at 08:01:36AM +0000, Yijing Wang wrote: > >> Document PCIE BUS MPS parameters pcie_bus_tune_off, pcie_bus_safe, > >> pcie_bus_peer2peer, pcie_bus_perf into Documentation/kernel-parameters.txt. > >> These parameters were introduced by Jon Mason <mason@myri.com> at > >> commit 5f39e6705 and commit b03e7495a8. Document these into > >> kernel-parameters.txt help users to understand and use the parameters. > >> > >> Signed-off-by: Yijing Wang <wangyijing@huawei.com> > >> --- > >> Documentation/kernel-parameters.txt | 13 +++++++++++++ > >> 1 files changed, 13 insertions(+), 0 deletions(-) > >> > >> diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt > >> index 363e348..4dfa8d2 100644 > >> --- a/Documentation/kernel-parameters.txt > >> +++ b/Documentation/kernel-parameters.txt > >> @@ -2227,6 +2227,19 @@ bytes respectively. Such letter suffixes can also be entirely omitted. > >> This sorting is done to get a device > >> order compatible with older (<= 2.4) kernels. > >> nobfsort Don't sort PCI devices into breadth-first order. > >> + pcie_bus_tune_off [X86] Disable PCI-E MPS turning and using > >> + the BIOS configured MPS defaults. > >> + pcie_bus_safe [X86] Use the smallest common denominator MPS > >> + of the entire tree below a root complex for every device > >> + on that fabric. Can avoid inconsistent mps problem caused > >> + by hotplug. > >> + pcie_bus_perf [X86] Configure pcie device MPS to the largest > >> + allowable MPS based on its parent bus.Improve performance > >> + as much as possible. > >> + pcie_bus_peer2peer [X86] Make the system wide MPS the smallest > >> + possible value (128B).This configuration could prevent it > >> + from working by having the MPS on one root port different > >> + than the MPS on another. > >> cbiosize=nn[KMG] The fixed amount of bus space which is > >> reserved for the CardBus bridge's IO window. > >> The default value is 256 bytes. > >> > > I was searching for documentation on this the other day. > > > > It's not just X86 that use these options, PowerPC and Tile also use them (grep > > for users of pcie_bus_configure_settings). I've also noticed a call to it from > > hotplug as well... > > Hi Andrew, > Thanks for reminder! I will update this patch right now. > > > > > In addition these options also have an effect on MRRS - I've not figured out > > what effect they have, but you can look in drivers/pci/probe.c at the > > pcie_write_mrrs function. > > This is a separate issue, Andrew, can you provide the effetct problem log or detail information? > That will helps us to analyze this issue. No this isn't a bug. When pcie_bus_perf is set, not only does it change the MPS as described in your documentation - but it also changes the MRRS for better performance. I felt this should also be included in your documentation of pcie_bus_perf. The pcie_write_mrrs function uses pcie_bus_config to determine if a change to the MRRS should be made. (What I don't understand is that the comments in this function suggest the MRRS cannot be larger than the MPS - I thought it could be?) Andrew Murray ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] PCI: Document PCIE BUS MPS parameters 2013-01-23 10:30 ` Andrew Murray @ 2013-01-23 11:44 ` Yijing Wang 0 siblings, 0 replies; 5+ messages in thread From: Yijing Wang @ 2013-01-23 11:44 UTC (permalink / raw) To: Andrew Murray, Jon Mason Cc: Yijing Wang, Rob Landley, Bjorn Helgaas, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-pci@vger.kernel.org, Hanjun Guo, jiang.liu@huawei.com On 2013/1/23 18:30, Andrew Murray wrote: > On Wed, Jan 23, 2013 at 10:13:02AM +0000, Yijing Wang wrote: >> ??? 2013-01-23 17:21, Andrew Murray ??????: >>> On Wed, Jan 23, 2013 at 08:01:36AM +0000, Yijing Wang wrote: >>>> Document PCIE BUS MPS parameters pcie_bus_tune_off, pcie_bus_safe, >>>> pcie_bus_peer2peer, pcie_bus_perf into Documentation/kernel-parameters.txt. >>>> These parameters were introduced by Jon Mason <mason@myri.com> at >>>> commit 5f39e6705 and commit b03e7495a8. Document these into >>>> kernel-parameters.txt help users to understand and use the parameters. >>>> >>>> Signed-off-by: Yijing Wang <wangyijing@huawei.com> >>>> --- >>>> Documentation/kernel-parameters.txt | 13 +++++++++++++ >>>> 1 files changed, 13 insertions(+), 0 deletions(-) >>>> >>>> diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt >>>> index 363e348..4dfa8d2 100644 >>>> --- a/Documentation/kernel-parameters.txt >>>> +++ b/Documentation/kernel-parameters.txt >>>> @@ -2227,6 +2227,19 @@ bytes respectively. Such letter suffixes can also be entirely omitted. >>>> This sorting is done to get a device >>>> order compatible with older (<= 2.4) kernels. >>>> nobfsort Don't sort PCI devices into breadth-first order. >>>> + pcie_bus_tune_off [X86] Disable PCI-E MPS turning and using >>>> + the BIOS configured MPS defaults. >>>> + pcie_bus_safe [X86] Use the smallest common denominator MPS >>>> + of the entire tree below a root complex for every device >>>> + on that fabric. Can avoid inconsistent mps problem caused >>>> + by hotplug. >>>> + pcie_bus_perf [X86] Configure pcie device MPS to the largest >>>> + allowable MPS based on its parent bus.Improve performance >>>> + as much as possible. >>>> + pcie_bus_peer2peer [X86] Make the system wide MPS the smallest >>>> + possible value (128B).This configuration could prevent it >>>> + from working by having the MPS on one root port different >>>> + than the MPS on another. >>>> cbiosize=nn[KMG] The fixed amount of bus space which is >>>> reserved for the CardBus bridge's IO window. >>>> The default value is 256 bytes. >>>> >>> I was searching for documentation on this the other day. >>> >>> It's not just X86 that use these options, PowerPC and Tile also use them (grep >>> for users of pcie_bus_configure_settings). I've also noticed a call to it from >>> hotplug as well... >> >> Hi Andrew, >> Thanks for reminder! I will update this patch right now. >> >>> >>> In addition these options also have an effect on MRRS - I've not figured out >>> what effect they have, but you can look in drivers/pci/probe.c at the >>> pcie_write_mrrs function. >> >> This is a separate issue, Andrew, can you provide the effetct problem log or detail information? >> That will helps us to analyze this issue. > > No this isn't a bug. When pcie_bus_perf is set, not only does it change the MPS > as described in your documentation - but it also changes the MRRS for better > performance. I felt this should also be included in your documentation of > pcie_bus_perf. Will add it. > > The pcie_write_mrrs function uses pcie_bus_config to determine if a change to > the MRRS should be made. > > (What I don't understand is that the comments in this function suggest the MRRS > cannot be larger than the MPS - I thought it could be?) I trace the change log about pcie_write_mrrs() function, my understanding for comment "it cannot be configured larger than the MPS the device or the bus can support" is that jon assume "device will never generate packets larger than MPS", so we can focus on upstream requests. If not, we should also concern the downstream request packet whether can be received by upstream device normally, maybe upstream mps is smaller than downstream device's mrrs. > > Andrew Murray > > > . > -- Thanks! Yijing ^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2013-01-23 11:45 UTC | newest] Thread overview: 5+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2013-01-23 8:01 [PATCH] PCI: Document PCIE BUS MPS parameters Yijing Wang 2013-01-23 9:21 ` Andrew Murray 2013-01-23 10:13 ` Yijing Wang 2013-01-23 10:30 ` Andrew Murray 2013-01-23 11:44 ` Yijing Wang
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox