Re: Editing QEMU POWER Platform wiki page
On Tue, 23 Feb 2021 08:18:17 + Mark Cave-Ayland wrote: > On 23/02/2021 07:59, Greg Kurz wrote: > > > On Tue, 23 Feb 2021 15:51:19 +1100 > > David Gibson wrote: > > > >> On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimarães > >> Garcia wrote: > >>> On 2/22/21 8:01 AM, Greg Kurz wrote: > On Thu, 18 Feb 2021 10:16:25 -0300 > Leonardo Augusto Guimarães Garcia wrote: > > > Hi there, > > > > I would like to edit the wiki page at [0] as it contains some outdated > > information. Could anyone that has access to the wiki please help me > > create a user so that I can edit it? > > > > 0. https://wiki.qemu.org/Documentation/Platforms/POWER > > > Hi Leo, > > User creation isn't publicly available to avoid spam : only an existing > user can create a new account. > >>> > >>> Yeah, I saw that. That's why I asked here. > >> > >> The other concerns raised in this thread are valid, but those > >> notwithstanding, I think it makes sense to let you update the Wiki if > >> you have the time and inclination. > >> > > > > Sure, but the point is that this incentive to update documentation > > would be better used in the main QEMU documentation, i.e. the > > docs/system/ppc/pseries.rst file in Cedric's "docs/system: Extend PPC > > section" patch. > > Certainly in an ideal world it would make sense to have everything held in > the > documentation, but in real life there are circumstances where having the wiki > is useful. > Hi Mark, I don't say wiki isn't useful, sorry if I wasn't clear. The current content of the POWER wiki page is extremely out-dated and would deserve a massive rewrite. Since we don't have any documentation for the pseries platform (e.g. supported devices) in the main documentation, I'm just suggesting to Leo to contribute there and then we'll link to it from the wiki. This also has the advantage of more reviewers and it will likely be better maintained. Then, if someone is also willing to provide extra documentation or examples or whatever, that's perfectly fine with me. Even recommended if it comes along an incentive to maintain that documentation as well ! :) Cheers, -- Greg > I spend a lot of my time with people interested in emulating older machines, > and for > these people who aren't particularly technical, the manual is far too > complicated: > all they want is examples, and to know what works and what doesn't. > > There was a recent thread where I think Peter discussed removing the > QuickStart > section from the documentation because it was out of date, and to me the wiki > is a > good replacement here - pretty much all of the content at > https://wiki.qemu.org/Documentation/Platforms/PowerPC is user-generated. I > also like > the wiki organisation of Documentation/Platforms/FOO since it's easy to point > people > towards tips that will help them get started on IRC. > > Another example is the SPARC page that I maintain at > https://wiki.qemu.org/Documentation/Platforms/SPARC which mainly came about > as people > kept emailing me off-list to ask whether a particular OS will run under QEMU, > and > would then follow up by asking me for examples because the QEMU command line > is > intimidating for new users. > > > ATB, > > Mark.
Re: Editing QEMU POWER Platform wiki page
On 23/02/2021 07:59, Greg Kurz wrote: On Tue, 23 Feb 2021 15:51:19 +1100 David Gibson wrote: On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimarães Garcia wrote: On 2/22/21 8:01 AM, Greg Kurz wrote: On Thu, 18 Feb 2021 10:16:25 -0300 Leonardo Augusto Guimarães Garcia wrote: Hi there, I would like to edit the wiki page at [0] as it contains some outdated information. Could anyone that has access to the wiki please help me create a user so that I can edit it? 0. https://wiki.qemu.org/Documentation/Platforms/POWER Hi Leo, User creation isn't publicly available to avoid spam : only an existing user can create a new account. Yeah, I saw that. That's why I asked here. The other concerns raised in this thread are valid, but those notwithstanding, I think it makes sense to let you update the Wiki if you have the time and inclination. Sure, but the point is that this incentive to update documentation would be better used in the main QEMU documentation, i.e. the docs/system/ppc/pseries.rst file in Cedric's "docs/system: Extend PPC section" patch. Certainly in an ideal world it would make sense to have everything held in the documentation, but in real life there are circumstances where having the wiki is useful. I spend a lot of my time with people interested in emulating older machines, and for these people who aren't particularly technical, the manual is far too complicated: all they want is examples, and to know what works and what doesn't. There was a recent thread where I think Peter discussed removing the QuickStart section from the documentation because it was out of date, and to me the wiki is a good replacement here - pretty much all of the content at https://wiki.qemu.org/Documentation/Platforms/PowerPC is user-generated. I also like the wiki organisation of Documentation/Platforms/FOO since it's easy to point people towards tips that will help them get started on IRC. Another example is the SPARC page that I maintain at https://wiki.qemu.org/Documentation/Platforms/SPARC which mainly came about as people kept emailing me off-list to ask whether a particular OS will run under QEMU, and would then follow up by asking me for examples because the QEMU command line is intimidating for new users. ATB, Mark.
Re: Editing QEMU POWER Platform wiki page
On Tue, 23 Feb 2021 15:51:19 +1100 David Gibson wrote: > On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimarães Garcia > wrote: > > On 2/22/21 8:01 AM, Greg Kurz wrote: > > > On Thu, 18 Feb 2021 10:16:25 -0300 > > > Leonardo Augusto Guimarães Garcia wrote: > > > > > > > Hi there, > > > > > > > > I would like to edit the wiki page at [0] as it contains some outdated > > > > information. Could anyone that has access to the wiki please help me > > > > create a user so that I can edit it? > > > > > > > > 0. https://wiki.qemu.org/Documentation/Platforms/POWER > > > > > > > Hi Leo, > > > > > > User creation isn't publicly available to avoid spam : only an existing > > > user can create a new account. > > > > Yeah, I saw that. That's why I asked here. > > The other concerns raised in this thread are valid, but those > notwithstanding, I think it makes sense to let you update the Wiki if > you have the time and inclination. > Sure, but the point is that this incentive to update documentation would be better used in the main QEMU documentation, i.e. the docs/system/ppc/pseries.rst file in Cedric's "docs/system: Extend PPC section" patch. > I have a wiki account, and I know who you are, so I've created an > account for you. Credentials to follow via private communication. > pgp_UvY9uakne.pgp Description: OpenPGP digital signature
Re: Editing QEMU POWER Platform wiki page
On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimarães Garcia wrote: > On 2/22/21 8:01 AM, Greg Kurz wrote: > > On Thu, 18 Feb 2021 10:16:25 -0300 > > Leonardo Augusto Guimarães Garcia wrote: > > > > > Hi there, > > > > > > I would like to edit the wiki page at [0] as it contains some outdated > > > information. Could anyone that has access to the wiki please help me > > > create a user so that I can edit it? > > > > > > 0. https://wiki.qemu.org/Documentation/Platforms/POWER > > > > > Hi Leo, > > > > User creation isn't publicly available to avoid spam : only an existing > > user can create a new account. > > Yeah, I saw that. That's why I asked here. The other concerns raised in this thread are valid, but those notwithstanding, I think it makes sense to let you update the Wiki if you have the time and inclination. I have a wiki account, and I know who you are, so I've created an account for you. Credentials to follow via private communication. -- David Gibson| I'll have my music baroque, and my code david AT gibson.dropbear.id.au | minimalist, thank you. NOT _the_ _other_ | _way_ _around_! http://www.ozlabs.org/~dgibson signature.asc Description: PGP signature
Re: Editing QEMU POWER Platform wiki page
On 2/22/21 8:01 AM, Greg Kurz wrote: On Thu, 18 Feb 2021 10:16:25 -0300 Leonardo Augusto Guimarães Garcia wrote: Hi there, I would like to edit the wiki page at [0] as it contains some outdated information. Could anyone that has access to the wiki please help me create a user so that I can edit it? 0. https://wiki.qemu.org/Documentation/Platforms/POWER Hi Leo, User creation isn't publicly available to avoid spam : only an existing user can create a new account. Yeah, I saw that. That's why I asked here. This being said, wiki isn't the preferred way to expose documentation since there's no review and things ultimately bitrot. Page [0] you want to update is a perfect example of the mess : not only it contains irrelevant data but also stuff that is definitely wrong (e.g. 'compat' cpu property was deprecated in QEMU 5.0 and will be removed in QEMU 6.0). Ideally we'd want everything to be in the main QEMU doc and don't even need a wiki. On the PowerPC front, the most up-to-date docs are in the QEMU tree: docs/system/ppc/embedded.rst docs/system/ppc/powermac.rst docs/system/ppc/powernv.rst docs/system/ppc/prep.rst docs/system/ppc/pseries.rst docs/system/target-ppc.rst So I don't know exactly what changes you had in mind, but maybe first consider to update the main documentation. I got here because someone pointed to me the wiki is saying that nested virtualization is not supported on Power, which is wrong. But I saw many other outdated information on the wiki as you pointed out. On my side, I think I want do ditch all the current content and just put links to https://qemu.readthedocs.io/en/latest/ instead. I can take care of that, in which case you wouldn't need an account. I agree this would be the preferable way. Could you go ahead and do that, please, if others agree as well? Cheers, Leo Cheers, -- Greg PS: Cedric reported that we also have a page for non-pseries platforms: https://wiki.qemu.org/Documentation/Platforms/PowerPC I'm Cc'ing some regular contributors for those platforms so they can evaluate the bitrotting status of this wiki. Cheers, Leo
Re: Editing QEMU POWER Platform wiki page
> On Feb 22, 2021, at 6:01 AM, Greg Kurz wrote: > > On Thu, 18 Feb 2021 10:16:25 -0300 > Leonardo Augusto Guimarães Garcia wrote: > >> Hi there, >> >> I would like to edit the wiki page at [0] as it contains some outdated >> information. Could anyone that has access to the wiki please help me >> create a user so that I can edit it? >> >> 0. https://wiki.qemu.org/Documentation/Platforms/POWER >> > > Hi Leo, > > User creation isn't publicly available to avoid spam : only an existing > user can create a new account. This being said, wiki isn't the preferred > way to expose documentation since there's no review and things ultimately > bitrot. Page [0] you want to update is a perfect example of the mess : > not only it contains irrelevant data but also stuff that is definitely > wrong (e.g. 'compat' cpu property was deprecated in QEMU 5.0 and will > be removed in QEMU 6.0). > > Ideally we'd want everything to be in the main QEMU doc and don't > even need a wiki. > > On the PowerPC front, the most up-to-date docs are in the QEMU tree: > > docs/system/ppc/embedded.rst > docs/system/ppc/powermac.rst > docs/system/ppc/powernv.rst > docs/system/ppc/prep.rst > docs/system/ppc/pseries.rst > docs/system/target-ppc.rst > > So I don't know exactly what changes you had in mind, but maybe first > consider to update the main documentation. > > On my side, I think I want do ditch all the current content and just put > links to https://qemu.readthedocs.io/en/latest/ instead. I can take care > of that, in which case you wouldn't need an account. > > Cheers, > > -- > Greg > > PS: > > Cedric reported that we also have a page for non-pseries > platforms: > > https://wiki.qemu.org/Documentation/Platforms/PowerPC > > I'm Cc'ing some regular contributors for those platforms so > they can evaluate the bitrotting status of this wiki. > >> Cheers, >> >> Leo Admittedly the wiki page for POWER is very unfriendly looking. I think it should be completely rewritten. This format should work better: - Description - IBM POWER system emulator - Build Directions - configure --target-list=ppc64-softmmu && make - Suggested Command-line - qemu-system-ppc64 -cpu POWER9 -machine pseries -m 2G -serial mon:stdio \ -cdrom -hda -boot d - Links - Linux iso files - AIX iso ? - https://worthdoingbadly.com/aixqemu/ - https://www.youtube.com/watch?v=OlajaCWvcdw - AIX 7.2 in QEMU - Pictures - Linux running in the POWER VM - AIX running in the POWER VM - Any games running in one of the above VM's - Productivity software like OpenOffice in the VM - Contacts - < maintainers' contact info > If you want I could update the wiki page for you. I just would need help with verifying the above information.
Re: Editing QEMU POWER Platform wiki page
On 2/22/21 12:01 PM, Greg Kurz wrote: > On Thu, 18 Feb 2021 10:16:25 -0300 > Leonardo Augusto Guimarães Garcia wrote: > >> Hi there, >> >> I would like to edit the wiki page at [0] as it contains some outdated >> information. Could anyone that has access to the wiki please help me >> create a user so that I can edit it? >> >> 0. https://wiki.qemu.org/Documentation/Platforms/POWER >> > > Hi Leo, > > User creation isn't publicly available to avoid spam : only an existing > user can create a new account. This being said, wiki isn't the preferred > way to expose documentation since there's no review and things ultimately > bitrot. Page [0] you want to update is a perfect example of the mess : > not only it contains irrelevant data but also stuff that is definitely > wrong (e.g. 'compat' cpu property was deprecated in QEMU 5.0 and will > be removed in QEMU 6.0). > > Ideally we'd want everything to be in the main QEMU doc and don't > even need a wiki. > > On the PowerPC front, the most up-to-date docs are in the QEMU tree: > > docs/system/ppc/embedded.rst > docs/system/ppc/powermac.rst > docs/system/ppc/powernv.rst > docs/system/ppc/prep.rst > docs/system/ppc/pseries.rst > docs/system/target-ppc.rst > > So I don't know exactly what changes you had in mind, but maybe first > consider to update the main documentation. This structure doesn't quite exist yet. See the patch below adding it. I would like to improve the PowerNV section before sending it. Thanks, C. >From f64cf0ab37848c44271437ef837ddda66206c4b9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Date: Mon, 22 Feb 2021 12:12:23 +0100 Subject: [PATCH] docs/system: Extend PPC section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Cédric Le Goater --- docs/system/ppc/embedded.rst | 10 +++ docs/system/ppc/powermac.rst | 34 +++ docs/system/ppc/powernv.rst | 11 docs/system/ppc/prep.rst | 18 docs/system/ppc/pseries.rst | 12 docs/system/target-ppc.rst | 53 ++-- 6 files changed, 100 insertions(+), 38 deletions(-) create mode 100644 docs/system/ppc/embedded.rst create mode 100644 docs/system/ppc/powermac.rst create mode 100644 docs/system/ppc/powernv.rst create mode 100644 docs/system/ppc/prep.rst create mode 100644 docs/system/ppc/pseries.rst diff --git a/docs/system/ppc/embedded.rst b/docs/system/ppc/embedded.rst new file mode 100644 index ..cfffbda24da9 --- /dev/null +++ b/docs/system/ppc/embedded.rst @@ -0,0 +1,10 @@ +Embedded family boards +== + +- ``bamboo`` bamboo +- ``mpc8544ds``mpc8544ds +- ``ppce500`` generic paravirt e500 platform +- ``ref405ep`` ref405ep +- ``sam460ex`` aCube Sam460ex +- ``taihu``taihu +- ``virtex-ml507`` Xilinx Virtex ML507 reference design diff --git a/docs/system/ppc/powermac.rst b/docs/system/ppc/powermac.rst new file mode 100644 index ..04334ba2102c --- /dev/null +++ b/docs/system/ppc/powermac.rst @@ -0,0 +1,34 @@ +PowerMac family boards (``g3beige``, ``mac99``) +== + +Use the executable ``qemu-system-ppc`` to simulate a complete PowerMac +PowerPC system. + +- ``g3beige`` Heathrow based PowerMAC +- ``mac99``Mac99 based PowerMAC + +Supported devices +- + +QEMU emulates the following PowerMac peripherals: + + * UniNorth or Grackle PCI Bridge + * PCI VGA compatible card with VESA Bochs Extensions + * 2 PMAC IDE interfaces with hard disk and CD-ROM support + * NE2000 PCI adapters + * Non Volatile RAM + * VIA-CUDA with ADB keyboard and mouse. + + +Missing devices +--- + + * To be identified + +Firmware + + +Since version 0.9.1, QEMU uses OpenBIOS https://www.openbios.org/ for +the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free +(GPL v2) portable firmware implementation. The goal is to implement a +100% IEEE 1275-1994 (referred to as Open Firmware) compliant firmware. diff --git a/docs/system/ppc/powernv.rst b/docs/system/ppc/powernv.rst new file mode 100644 index ..28ce09aa4513 --- /dev/null +++ b/docs/system/ppc/powernv.rst @@ -0,0 +1,11 @@ +PowerNV family boards (``powernv8``, ``powernv9``) +== + +Supported devices +- + +Missing devices +--- + +Firmware + diff --git a/docs/system/ppc/prep.rst b/docs/system/ppc/prep.rst new file mode 100644 index ..bd9eb8eabd2f --- /dev/null +++ b/docs/system/ppc/prep.rst @@ -0,0 +1,18 @@ +Prep machine (``40p``) +== + +Use the executable ``qemu-system-ppc`` to simulate a complete 40P (PREP) + +Supported devices
Re: Editing QEMU POWER Platform wiki page
On Thu, 18 Feb 2021 10:16:25 -0300 Leonardo Augusto Guimarães Garcia wrote: > Hi there, > > I would like to edit the wiki page at [0] as it contains some outdated > information. Could anyone that has access to the wiki please help me > create a user so that I can edit it? > > 0. https://wiki.qemu.org/Documentation/Platforms/POWER > Hi Leo, User creation isn't publicly available to avoid spam : only an existing user can create a new account. This being said, wiki isn't the preferred way to expose documentation since there's no review and things ultimately bitrot. Page [0] you want to update is a perfect example of the mess : not only it contains irrelevant data but also stuff that is definitely wrong (e.g. 'compat' cpu property was deprecated in QEMU 5.0 and will be removed in QEMU 6.0). Ideally we'd want everything to be in the main QEMU doc and don't even need a wiki. On the PowerPC front, the most up-to-date docs are in the QEMU tree: docs/system/ppc/embedded.rst docs/system/ppc/powermac.rst docs/system/ppc/powernv.rst docs/system/ppc/prep.rst docs/system/ppc/pseries.rst docs/system/target-ppc.rst So I don't know exactly what changes you had in mind, but maybe first consider to update the main documentation. On my side, I think I want do ditch all the current content and just put links to https://qemu.readthedocs.io/en/latest/ instead. I can take care of that, in which case you wouldn't need an account. Cheers, -- Greg PS: Cedric reported that we also have a page for non-pseries platforms: https://wiki.qemu.org/Documentation/Platforms/PowerPC I'm Cc'ing some regular contributors for those platforms so they can evaluate the bitrotting status of this wiki. > Cheers, > > Leo > >
Editing QEMU POWER Platform wiki page
Hi there, I would like to edit the wiki page at [0] as it contains some outdated information. Could anyone that has access to the wiki please help me create a user so that I can edit it? 0. https://wiki.qemu.org/Documentation/Platforms/POWER Cheers, Leo