Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/807172/?format=api
{ "id": 807172, "url": "http://patchwork.ozlabs.org/api/patches/807172/?format=api", "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/patch/1504025019-16820-4-git-send-email-chugh.ishani@research.iiit.ac.in/", "project": { "id": 14, "url": "http://patchwork.ozlabs.org/api/projects/14/?format=api", "name": "QEMU Development", "link_name": "qemu-devel", "list_id": "qemu-devel.nongnu.org", "list_email": "qemu-devel@nongnu.org", "web_url": "", "scm_url": "", "webscm_url": "", "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<1504025019-16820-4-git-send-email-chugh.ishani@research.iiit.ac.in>", "list_archive_url": null, "date": "2017-08-29T16:43:39", "name": "[v2,3/3] Add manpage for QEMU Backup Tool", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "0f1b6d25edccdebaa69ab219904b71d9223a24c9", "submitter": { "id": 71382, "url": "http://patchwork.ozlabs.org/api/people/71382/?format=api", "name": "Ishani", "email": "chugh.ishani@research.iiit.ac.in" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/patch/1504025019-16820-4-git-send-email-chugh.ishani@research.iiit.ac.in/mbox/", "series": [ { "id": 406, "url": "http://patchwork.ozlabs.org/api/series/406/?format=api", "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/list/?series=406", "date": "2017-08-29T16:43:37", "name": "QEMU Backup Tool", "version": 2, "mbox": "http://patchwork.ozlabs.org/series/406/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/807172/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/807172/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>", "X-Original-To": "incoming@patchwork.ozlabs.org", "Delivered-To": "patchwork-incoming@bilbo.ozlabs.org", "Authentication-Results": [ "ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=nongnu.org\n\t(client-ip=2001:4830:134:3::11; helo=lists.gnu.org;\n\tenvelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n\treceiver=<UNKNOWN>)", "ozlabs.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n\tunprotected) header.d=research.iiit.ac.in\n\theader.i=@research.iiit.ac.in header.b=\"r5t+/b5l\"; \n\tdkim-atps=neutral" ], "Received": [ "from lists.gnu.org (lists.gnu.org [IPv6:2001:4830:134:3::11])\n\t(using TLSv1 with cipher AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 3xhZKx2DVgz9t38\n\tfor <incoming@patchwork.ozlabs.org>;\n\tWed, 30 Aug 2017 02:46:59 +1000 (AEST)", "from localhost ([::1]:46080 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>)\n\tid 1dmjfF-0002Qk-Kk\n\tfor incoming@patchwork.ozlabs.org; Tue, 29 Aug 2017 12:46:57 -0400", "from eggs.gnu.org ([2001:4830:134:3::10]:46285)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from <chugh.ishani@research.iiit.ac.in>)\n\tid 1dmjcD-0008DP-JF\n\tfor qemu-devel@nongnu.org; Tue, 29 Aug 2017 12:43:51 -0400", "from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from <chugh.ishani@research.iiit.ac.in>)\n\tid 1dmjc9-0006D7-QD\n\tfor qemu-devel@nongnu.org; Tue, 29 Aug 2017 12:43:49 -0400", "from research.iiit.ac.in ([196.12.53.8]:43446)\n\tby eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)\n\t(Exim 4.71) (envelope-from <chugh.ishani@research.iiit.ac.in>)\n\tid 1dmjc9-0006BU-4v\n\tfor qemu-devel@nongnu.org; Tue, 29 Aug 2017 12:43:45 -0400", "from localhost (localhost [127.0.0.1])\n\tby research.iiit.ac.in (Postfix) with ESMTP id 4ABAA744793;\n\tTue, 29 Aug 2017 22:13:42 +0530 (IST)", "from research.iiit.ac.in ([127.0.0.1])\n\tby localhost (research.iiit.ac.in [127.0.0.1]) (amavisd-new,\n\tport 10032)\n\twith ESMTP id KFqkP3KbwB6k; Tue, 29 Aug 2017 22:13:38 +0530 (IST)", "from localhost (localhost [127.0.0.1])\n\tby research.iiit.ac.in (Postfix) with ESMTP id 99EDC741A9B;\n\tTue, 29 Aug 2017 22:13:38 +0530 (IST)", "from research.iiit.ac.in ([127.0.0.1])\n\tby localhost (research.iiit.ac.in [127.0.0.1]) (amavisd-new,\n\tport 10026)\n\twith ESMTP id N_Lk5IMijOZn; Tue, 29 Aug 2017 22:13:38 +0530 (IST)", "from ishani-Inspiron-5558.iiit.ac.in (unknown [10.2.20.52])\n\tby research.iiit.ac.in (Postfix) with ESMTPSA id 7A0F574203C;\n\tTue, 29 Aug 2017 22:13:38 +0530 (IST)" ], "DKIM-Filter": "OpenDKIM Filter v2.9.2 research.iiit.ac.in 99EDC741A9B", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=research.iiit.ac.in; \n\ts=4E8815E6-5B55-11E4-B758-8D4964374E96; t=1504025018;\n\tbh=t+nJxYvRlw61frSZEKYZcR3T3UIVh+s2Pfysadfr3sE=;\n\th=From:To:Subject:Date:Message-Id;\n\tb=r5t+/b5ljjcFbqXSGxqIAR2qeJ4LW3Cf1HYjHUYT8gPQb3PWBb/LSOjj4/6UPures\n\tSM4ZbKzTMoJKDvGPf2nxaaprPe/dT5f4Lhwz5AW5An0jH0IqnvO2zH4NSxunWis1AA\n\tnhYwuW4RMsLmdQ4v+HNBNxzAn5H0yL50dMXgKW+U=", "X-Virus-Scanned": "amavisd-new at research.iiit.ac.in", "From": "Ishani Chugh <chugh.ishani@research.iiit.ac.in>", "To": "qemu-devel@nongnu.org", "Date": "Tue, 29 Aug 2017 22:13:39 +0530", "Message-Id": "<1504025019-16820-4-git-send-email-chugh.ishani@research.iiit.ac.in>", "X-Mailer": "git-send-email 2.7.4", "In-Reply-To": "<1504025019-16820-1-git-send-email-chugh.ishani@research.iiit.ac.in>", "References": "<1504025019-16820-1-git-send-email-chugh.ishani@research.iiit.ac.in>", "X-detected-operating-system": "by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]\n\t[fuzzy]", "X-Received-From": "196.12.53.8", "Subject": "[Qemu-devel] [PATCH v2 3/3] Add manpage for QEMU Backup Tool", "X-BeenThere": "qemu-devel@nongnu.org", "X-Mailman-Version": "2.1.21", "Precedence": "list", "List-Id": "<qemu-devel.nongnu.org>", "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n\t<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>", "List-Archive": "<http://lists.nongnu.org/archive/html/qemu-devel/>", "List-Post": "<mailto:qemu-devel@nongnu.org>", "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>", "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n\t<mailto:qemu-devel-request@nongnu.org?subject=subscribe>", "Cc": "Ishani Chugh <chugh.ishani@research.iiit.ac.in>, jsnow@redhat.com,\n\tstefanha@redhat.com", "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org", "Sender": "\"Qemu-devel\"\n\t<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>" }, "content": "qemu-backup will be a command-line tool for performing full and\nincremental disk backups on running VMs. It is intended as a\nreference implementation for management stack and backup developers\nto see QEMU's backup features in action. The following commit is an\ninitial implementation of manpage listing the commands which the\nbackup tool will support. The manpage wil be build along with other\ndocs when configure is provided with --enable-docs flag in the\nlocation contrib/backup in build directory.\n\n\nSigned-off-by: Ishani Chugh <chugh.ishani@research.iiit.ac.in>\n---\n Makefile | 14 ++--\n contrib/backup/qemu-backup.texi | 144 ++++++++++++++++++++++++++++++++++++++++\n 2 files changed, 154 insertions(+), 4 deletions(-)\n create mode 100644 contrib/backup/qemu-backup.texi", "diff": "diff --git a/Makefile b/Makefile\nindex 81447b1..ba1574d 100644\n--- a/Makefile\n+++ b/Makefile\n@@ -209,6 +209,7 @@ ifdef BUILD_DOCS\n DOCS=qemu-doc.html qemu-doc.txt qemu.1 qemu-img.1 qemu-nbd.8 qemu-ga.8\n DOCS+=docs/interop/qemu-qmp-ref.html docs/interop/qemu-qmp-ref.txt docs/interop/qemu-qmp-ref.7\n DOCS+=docs/interop/qemu-ga-ref.html docs/interop/qemu-ga-ref.txt docs/interop/qemu-ga-ref.7\n+DOCS+=contrib/backup/qemu-backup.html contrib/backup/qemu-backup.txt\n ifdef CONFIG_VIRTFS\n DOCS+=fsdev/virtfs-proxy-helper.1\n endif\n@@ -508,6 +509,8 @@ VERSION ?= $(shell cat VERSION)\n \n dist: qemu-$(VERSION).tar.bz2\n \n+qemu-backup.8: contrib/backup/qemu-backup.texi\n+\n qemu-%.tar.bz2:\n \t$(SRC_PATH)/scripts/make-release \"$(SRC_PATH)\" \"$(patsubst qemu-%.tar.bz2,%,$@)\"\n \n@@ -719,16 +722,19 @@ fsdev/virtfs-proxy-helper.1: fsdev/virtfs-proxy-helper.texi\n qemu-nbd.8: qemu-nbd.texi qemu-option-trace.texi\n qemu-ga.8: qemu-ga.texi\n \n-html: qemu-doc.html docs/interop/qemu-qmp-ref.html docs/interop/qemu-ga-ref.html\n-info: qemu-doc.info docs/interop/qemu-qmp-ref.info docs/interop/qemu-ga-ref.info\n-pdf: qemu-doc.pdf docs/interop/qemu-qmp-ref.pdf docs/interop/qemu-ga-ref.pdf\n-txt: qemu-doc.txt docs/interop/qemu-qmp-ref.txt docs/interop/qemu-ga-ref.txt\n+html: qemu-doc.html docs/interop/qemu-qmp-ref.html docs/interop/qemu-ga-ref.html contrib/backup/qemu-backup.html\n+info: qemu-doc.info docs/interop/qemu-qmp-ref.info docs/interop/qemu-ga-ref.info contrib/backup/qemu-backup.info\n+pdf: qemu-doc.pdf docs/interop/qemu-qmp-ref.pdf docs/interop/qemu-ga-ref.pdf contrib/backup/qemu-backup.pdf\n+txt: qemu-doc.txt docs/interop/qemu-qmp-ref.txt docs/interop/qemu-ga-ref.txt contrib/backup/qemu-backup.txt\n \n qemu-doc.html qemu-doc.info qemu-doc.pdf qemu-doc.txt: \\\n \tqemu-img.texi qemu-nbd.texi qemu-options.texi qemu-option-trace.texi \\\n \tqemu-monitor.texi qemu-img-cmds.texi qemu-ga.texi \\\n \tqemu-monitor-info.texi\n \n+contrib/backup/qemu-backup.html contrib/backup/qemu-backup.pdf contrib/backup/qemu-backup.txt contrib/backup/qemu-backup.info: \\\n+\tcontrib/backup/qemu-backup.texi\n+\n docs/interop/qemu-ga-ref.dvi docs/interop/qemu-ga-ref.html \\\n docs/interop/qemu-ga-ref.info docs/interop/qemu-ga-ref.pdf \\\n docs/interop/qemu-ga-ref.txt docs/interop/qemu-ga-ref.7: \\\ndiff --git a/contrib/backup/qemu-backup.texi b/contrib/backup/qemu-backup.texi\nnew file mode 100644\nindex 0000000..68e7231\n--- /dev/null\n+++ b/contrib/backup/qemu-backup.texi\n@@ -0,0 +1,144 @@\n+\\input texinfo\n+@setfilename qemu-backup\n+\n+@documentlanguage en\n+@documentencoding UTF-8\n+\n+@settitle QEMU Backup Tool\n+@copying\n+\n+Copyright @copyright{} 2017 The QEMU Project developers\n+@end copying\n+@ifinfo\n+@direntry\n+* QEMU: (QEMU-backup). Man page for QEMU Backup Tool.\n+@end direntry\n+@end ifinfo\n+@iftex\n+@titlepage\n+@sp 7\n+@center @titlefont{QEMU Backup Tool}\n+@sp 1\n+@sp 3\n+@end titlepage\n+@end iftex\n+@ifnottex\n+@node Top\n+@top Short Sample\n+\n+@menu\n+* Name::\n+* Synopsis::\n+* List of Commands::\n+* Command Parameters::\n+* Command Descriptions::\n+* License::\n+@end menu\n+\n+@end ifnottex\n+\n+@node Name\n+@chapter Name\n+\n+QEMU disk backup tool.\n+\n+@node Synopsis\n+@chapter Synopsis\n+\n+qemu-backup command [command options].\n+\n+@node List of Commands\n+@chapter List of Commands\n+@itemize\n+@item qemu-backup guest add --guest guestname --qmp socketpath\n+@item qemu-backup guest list\n+@item qemu-backup drive add --id driveid --guest guestname --target target\n+@item qemu-backup drive add --all --guest guestname --target target\n+@item qemu-backup drive list --guest guestname\n+@item qemu-backup backup [--inc] --guest guestname\n+@item qemu-backup restore --guest guestname\n+@item qemu-backup guest remove --guest guestname\n+@item qemu-backup drive remove --guest guestname --id driveid\n+@end itemize\n+@node Command Parameters\n+@chapter Command Parameters\n+@itemize\n+@item --all: Add all the drives present in a guest which are suitable for backup.\n+@item --guest: Name of the guest.\n+@item --id: id of guest or drive.\n+@item --inc: (Optional) For incremental backup.\n+@item --qmp: Path of qmp socket.\n+@item --target: Destination path on which you want your backup to be made.\n+@end itemize\n+\n+@node Command Descriptions\n+@chapter Command Descriptions\n+@itemize\n+@item qemu-backup guest add --guest guestname --qmp socketpath\n+This command adds a guest to the configuration file given its path to qmp socket.\n+\n+example:\n+qemu-backup guest add --id=fedora --qmp=unix:/var/run/qemu/fedora.sock\n+\n+qemu-backup guest add --id=fedora --qmp=tcp:localhost:4444\n+\n+@item qemu-backup guest list\n+This commands lists the names of guests which are added to configuration file.\n+\n+@item qemu-backup drive add --guest guestname --id driveid --target target\n+This command adds different drives for backup in a particular guest by giving the name of drive to be backed up and target imagefile in which we want to store the drive backup.\n+\n+example: qemu-backup drive add --guest=fedora --id=root --target=/backup/root.img\n+\n+@item qemu-backup drive add --all --guest guestname --destination destination\n+This command adds all the drives of the guest for backup other than CDROM drive and read-only drives. Here all the backup drives will have the same names as original drives and target will be the destination folder.\n+\n+example: qemu-backup drive add --all --guest fedora --destination =/backup/fedora/\n+\n+@item qemu-backup drive list --guest guestname\n+This commands gives the names of the drive present in a guest which are added for backup.\n+\n+example: qemu-backup drive list --guest=fedora\n+\n+@item qemu-backup backup --guest guestname\n+\n+This command makes the backup of the drives, in their respective given destinations. The ids of drive and their destinations are taken from the configuration file.\n+\n+example: qemu-backup backup --guest=fedora\n+\n+@item qemu-backup restore --guest guestname\n+This command is needed if we want to restore the backup. It will list the commands to be run for performing the same but will not perform any action.\n+\n+example: qemu-backup restore --guest=fedora\n+\n+@item qemu-backup guest remove --guest guestname\n+This command removes the guest from the configuration file.\n+\n+example: qemu-backup guest remove --guest=fedora\n+\n+@item qemu-backup drive remove --guest guestname --id driveid\n+This command helps remove a drive which is set for backup in configuration of given host.\n+\n+example: drive remove --guest=fedora --id=root\n+\n+@item A full backup can be performed by following the given steps:\n+\n+Perform a full backup of 'vm001', which has one drive:\n+\n+qemu-backup guest add --guest vm001 --qmp /path/to/vm001.sock\n+\n+qemu-backup add --id drive0 --guest vm001 --target /backups/vm001-drive0.img\n+\n+qemu-backup backup --guest vm001\n+\n+\n+@end itemize\n+\n+@node License\n+@appendix License\n+QEMU is a trademark of Fabrice Bellard.\n+QEMU is released under the\n+@url{https://www.gnu.org/licenses/gpl-2.0.txt,GNU General Public License},\n+version 2. Parts of QEMU have specific licenses, see file\n+@url{http://git.qemu.org/?p=qemu.git;a=blob_plain;f=LICENSE,LICENSE}.\n+@bye\n", "prefixes": [ "v2", "3/3" ] }