Contribute: Difference between revisions

From QEMU
No edit summary
m (→‎Project Infrastructure: Update Tuesdays call schedule)
 
(133 intermediate revisions by 37 users not shown)
Line 1: Line 1:
QEMU uses [http://www.gitscm.org git] for revision control. We host a number of repositories on http://git.qemu.org.
== Project Infrastructure ==
* [http://git.qemu.org Mainline qemu.git] source repository (for developer repositories see the {{src|path=MAINTAINERS}} file).
* [[Contribute/MailingLists|Mailing lists]]: savannah.nongnu.org
* IRC: #qemu on [http://www.oftc.net/ irc.oftc.net]
* [https://www.qemu.org/contribute/report-a-bug/ Bug tracker]: [https://gitlab.com/qemu-project/qemu/-/issues GitLab Issues]
* [[Testing#Continuous_Integration|Continuous Integration]]: [https://gitlab.com/qemu-project/qemu/-/pipelines GitLab CI], [http://patchew.org/QEMU/ Patchew] and [https://travis-ci.org/qemu/qemu Travis]
* [[Main_Page|Wiki]]: this website
* Phone call: Scheduled for Tuesdays on as-needed basis for agenda topics raised on mailing list.  Contact [mailto:quintela@redhat.com Juan Quintela] for dial-in details.  To find the time in your location, use:
date -d 'TZ="America/New_York" Tuesday 09:00 am'
* If you need to find out or change who's responsible for a particular bit of our infrastructure [[AdminContacts]] has this information.
* [[ToDo]] lists


== Submitting patches ==
== Info for new Contributors ==
* [[Contribute/DevelopmentProcess|The Development Process]]
* [https://www.qemu.org/contribute/report-a-bug/ How to report a bug]
* [[Documentation/GettingStartedDevelopers|Getting started for developers]]
* [https://qemu.org/contribute/submit-a-patch/ How to submit a patch]
* [https://qemu.org/contribute/trivial-patches/ How to submit a trivial patch]
* [[Contribute/BiteSizedTasks|Bite Sized Tasks]]: Introductory task list for new contributors
* [[Contribute/FAQ|Contributor FAQ]]


All contributions to QEMU are sent in patch form to the qemu-devel [[MailingLists|mailing list]].
See also Jeff Cody's presentation [https://www.youtube.com/watch?v=yjBid6iF4LE "New to QEMU: A Developer's Guide to Contributing"] on YouTube for some information about how to get started.


Send patches inline so they are easy to reply to with review comments.  Do not put patches in attachments.
== Student Outreach ==


Patch emails must include a Signed-off-by: line.  For more information see [http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/SubmittingPatches;h=689e2371095cc5dfea9927120009341f369159aa;hb=f6f94e2ab1b33f0082ac22d71f66385a60d8157f#l297 SubmittingPatches 1.12].
The QEMU project participates in both the [[:Category:GSoC|Google Summer of Code]] and the [[:Category:Outreachy|Outreachy]] programs. See the respective pages for details of project ideas and deadlines for submissions.


Make sure to follow the coding style:
== Development ==
* [http://git.qemu.org/qemu.git/plain/CODING_STYLE QEMU Coding Style]
The [[planning]] pages is where you can find important dates for the next release.
* [http://git.qemu.org/qemu.git/plain/HACKING QEMU Coding Guidelines]


Split up longer patches into a patch series of logical code changes.  Each change should compile and execute successfully.
The [[features]] page provides a description of in-progress features.


== Students ==
== Subpages ==


QEMU is participating in Google's Summer of Code 2010 program.  For more information, see [[Google_Summer_of_Code_2010|this page]].
Here are all the sub-pages for contribute
* [[Google Summer of Code 2010/QMP|QMP]]
* [[Google Summer of Code 2010/VNC|VNC]]


== Features ==
{{Special:PrefixIndex/Contribute/}}
* [[Features/0.13|Proposed 0.13 Features]]
* [[Features/0.13/HelperNetworking|0.13/HelperNetworking]]
* [[Features/CPUModels|CPUModels]]
* [[Features/DriveRefactoring|DriveRefactoring]]
* [[Features/GtkDisplayState|GtkDisplayState]]
* [[Features/HelperNetworking|HelperNetworking]]
* [[Features/NetDeviceFailover|NetDeviceFailover]]
* [[Features/PCIMemoryAPI|PCIMemoryAPI]]
* [[Features/PVCrashDetection|PVCrashDetection]]
* [[Features/Qcow2DataIntegrity|Qcow2DataIntegrity]]
* [[Features/RamAPI|RamAPI]]
* [[Features/Usability|Usability]]
* [[Features/VirtioBlkBoot|VirtioBlkBoot]]
* [[Features/FaultTolerance|FaultTolerance]]
* [[Features/ResetAPI|ResetAPI]]
 
* [[Features |/Features ]]
* [[Features/0.13 |0.13 ]]
* [[Features/AHCI |AHCI ]]
* [[Features/Cow2 |Cow2 ]]
* [[Features/QDevCleanup |QDevCleanup ]]
* [[Features/QMP2 |QMP2 ]]
* [[Features/QMP_0.14 |QMP_0.14 ]]
* [[Features/SnapshottingImprovements |SnapshottingImprovements ]]
* [[Features/TCI |TCG Interpreter ]]
* [[Features/Tracing |Tracing ]]
* [[Features/Tracing/Roadmap |Tracing/Roadmap ]]
* [[Features/Tracing/UseCases |Tracing/UseCases ]]
* [[Features/Usability |Usability ]]
* [[Features/Sheepdog |Sheepdog ]]
 
== GIT repo ==
* [http://git.savannah.gnu.org/gitweb/?p=qemu.git;a=summary GNU savannah GIT repo]
* [http://git.qemu.org/ QEMU.org GIT repo]
* [http://repo.or.cz/w/qemu.git repo.or.cz]
* [http://repo.or.cz/w/qemu/aliguori.git Anthony Liguori's QEMU tree]
* [http://repo.or.cz/w/qemu/aliguori-queue.git Anthony Liguori's QEMU queue]
* [http://git.kernel.org/?p=linux/kernel/git/mst/qemu.git;a=summary Qemu patches by Michael S. Tsirkin. Warning: constantly rebased. pci subsystem]
* [http://repo.or.cz/w/qemu/kevin.git kwolf Random patches. block device]
 
== Developers ==
 
* [[User:Agraf |Alexander Graf ]]
* [[User:AnthonyLiguori |Anthony Liguori ]]
* [[User:Wmat |Bill Traynor  ]]
* [[User:Blueswirl |Blueswirl ]]
* [[User:edgar |Edgar E. Iglesias ]]
* [[User:Joro |Joro ]]
* [[User:LuizCapitulino |Luiz Capitulino ]]
* [[User:Mariusmm |Màrius Montón ]]
* [[User:Miguel |Miguel Di Ciurcio Filho ]]
* [[User:NataliaPortillo |Natalia Portillo ]]
* [[User:Paolo_Bonzini |Paolo Bonzini ]]
* [[User:Pbrook |Paul Brook ]]
* [[User:Rowa |Robert Warnke ]]
* [[User:Stefan_Weil |Stefan Weil ]]
* [[User:Stefanha |Stefanha ]]

Latest revision as of 11:51, 25 January 2022

Project Infrastructure

date -d 'TZ="America/New_York" Tuesday 09:00 am'
  • If you need to find out or change who's responsible for a particular bit of our infrastructure AdminContacts has this information.
  • ToDo lists

Info for new Contributors

See also Jeff Cody's presentation "New to QEMU: A Developer's Guide to Contributing" on YouTube for some information about how to get started.

Student Outreach

The QEMU project participates in both the Google Summer of Code and the Outreachy programs. See the respective pages for details of project ideas and deadlines for submissions.

Development

The planning pages is where you can find important dates for the next release.

The features page provides a description of in-progress features.

Subpages

Here are all the sub-pages for contribute