From patchwork Thu Oct 18 07:12:52 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Artem Pisarenko X-Patchwork-Id: 10646795 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id B9CAA17D4 for ; Thu, 18 Oct 2018 07:14:54 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id A78B8204FB for ; Thu, 18 Oct 2018 07:14:54 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 9BA0D2522B; Thu, 18 Oct 2018 07:14:54 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.7 required=2.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 3F3F3204FB for ; Thu, 18 Oct 2018 07:14:54 +0000 (UTC) Received: from localhost ([::1]:40602 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gD2WD-0005Fo-GC for patchwork-qemu-devel@patchwork.kernel.org; Thu, 18 Oct 2018 03:14:53 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:32968) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gD2Ut-0004Oh-1A for qemu-devel@nongnu.org; Thu, 18 Oct 2018 03:13:31 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gD2Us-0008H3-7C for qemu-devel@nongnu.org; Thu, 18 Oct 2018 03:13:31 -0400 Received: from mail-lj1-x241.google.com ([2a00:1450:4864:20::241]:36507) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gD2Ur-0008FB-Up for qemu-devel@nongnu.org; Thu, 18 Oct 2018 03:13:30 -0400 Received: by mail-lj1-x241.google.com with SMTP id p89-v6so26725951ljb.3 for ; Thu, 18 Oct 2018 00:13:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :in-reply-to:references; bh=FLqkhNN/tldODA+vTtpezLR8Rd8RwfY+oIHHL84yThw=; b=h4ZMJah+3tK1WO74Zr7DZfnEmih7xljNrSEK3xzmJ/II9fk9tK/W/VtgLy/4E7gHDW sMCgR1RVYvbS6qqE2QaN5ih/SCuClNfLmQGNUySw88C4gFJsRTgvVR3ARJjuS9s1w8m4 6ZN7SUuT+S8ZNpHRSgjorswwrPOCaFKrgw0t1EPtQPBU4dgB5j5fhku65UcPlprcLj4B VyofU4JNkgGTsedu992GUXTL+eWVmBuvfmT2zAQzXB1wVZkv8fafs3ffPMn3iVjfwzH2 2TXQAHmm7OhSLD44JC2Hd3TM16liaCu/QTSerrzjsGWi4QPGLfuLIn8G2DwBpjH1708f BAYA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:in-reply-to:references; bh=FLqkhNN/tldODA+vTtpezLR8Rd8RwfY+oIHHL84yThw=; b=pxM0Ze3d4fGOObo6UgNhuwEKQ3rre4cecdjybrRB2PBvOAp3fN01wrNEM64m9TSUXR cTVQPTLqEj9Nx3VH7PrRqlGEB78N1T1NtU4rL8JtlsAmQUB83/Pxlc4b+nHDAw8fkv9K gNOb0tCW4Os2w/12KN1oO8bHn1DbMwQNi3Y2/mItzPUP+9CQydfHZ4UwTPuiA/A19FK/ rTeZ3f8WDKla9IsnkLQQijTEtxvlFIa0FVUuyPjuUgz4Bc2cvzKREm1TO0/KpgnwCi29 yY2azCoSrGKXIS5rngHQsEWpN8cQ70FB4mi7WipFg3+qDWxYEkcHM4xkWdF74/ATBO8Q x/SA== X-Gm-Message-State: ABuFfojGTOEuoHVpedsUdhdp8GyCROl8TfJ5qQmsVh7wdrtRv4itVpR7 z91Dpeilpnyr/QbEbqZuBXW93k/bLxg= X-Google-Smtp-Source: ACcGV61FKHKLunawZzptaageNOils+VfYRpJmlGr2GToDjqsN8OimAL0pjhf2WXc4/tEu2AAriof/g== X-Received: by 2002:a2e:2a43:: with SMTP id q64-v6mr18492671ljq.153.1539846808257; Thu, 18 Oct 2018 00:13:28 -0700 (PDT) Received: from localhost.localdomain ([77.221.221.49]) by smtp.gmail.com with ESMTPSA id r4-v6sm4445426ljg.12.2018.10.18.00.13.27 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 18 Oct 2018 00:13:27 -0700 (PDT) From: Artem Pisarenko To: qemu-devel@nongnu.org Date: Thu, 18 Oct 2018 13:12:52 +0600 Message-Id: <1b245c6c0803d4bf11dcbf9eb32f34af8c2bd0b4.1539846575.git.artem.k.pisarenko@gmail.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: References: In-Reply-To: References: X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::241 Subject: [Qemu-devel] [PATCH v3 1/4] vl: improve/fix documentation related to RTC function X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Artem Pisarenko Errors-To: qemu-devel-bounces+patchwork-qemu-devel=patchwork.kernel.org@nongnu.org Sender: "Qemu-devel" X-Virus-Scanned: ClamAV using ClamSMTP Documentation describing -rtc option updated to better match current implementation and highlight some important specifics. Signed-off-by: Artem Pisarenko --- qemu-options.hx | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/qemu-options.hx b/qemu-options.hx index f139459..4a9c065 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -3458,25 +3458,29 @@ HXCOMM Silently ignored for compatibility DEF("clock", HAS_ARG, QEMU_OPTION_clock, "", QEMU_ARCH_ALL) DEF("rtc", HAS_ARG, QEMU_OPTION_rtc, \ - "-rtc [base=utc|localtime|date][,clock=host|rt|vm][,driftfix=none|slew]\n" \ + "-rtc [base=utc|localtime|][,clock=host|rt|vm][,driftfix=none|slew]\n" \ " set the RTC base and clock, enable drift fix for clock ticks (x86 only)\n", QEMU_ARCH_ALL) STEXI -@item -rtc [base=utc|localtime|@var{date}][,clock=host|vm][,driftfix=none|slew] +@item -rtc [base=utc|localtime|@var{datetime}][,clock=host|rt|vm][,driftfix=none|slew] @findex -rtc Specify @option{base} as @code{utc} or @code{localtime} to let the RTC start at the current UTC or local time, respectively. @code{localtime} is required for correct date in -MS-DOS or Windows. To start at a specific point in time, provide @var{date} in the +MS-DOS or Windows. To start at a specific point in time, provide @var{datetime} in the format @code{2006-06-17T16:01:21} or @code{2006-06-17}. The default base is UTC. By default the RTC is driven by the host system time. This allows using of the RTC as accurate reference clock inside the guest, specifically if the host time is smoothly following an accurate external reference clock, e.g. via NTP. If you want to isolate the guest time from the host, you can set @option{clock} -to @code{rt} instead. To even prevent it from progressing during suspension, -you can set it to @code{vm}. +to @code{rt} instead, which provides host monotonic clock if host support it. +To even prevent it from progressing during suspension, you can set it to +@code{vm} (virtual clock). Virtual clock is the clock seen by guest, +In icount mode of emulation its (long term) speed will be different from +any host clock, when icount configured to non-auto value or virtual cpu sleeping +is off, and no synchronization algorithm is active. Enable @option{driftfix} (i386 targets only) if you experience time drift problems, specifically with Windows' ACPI HAL. This option will try to figure out how