From nobody Thu Nov 6 06:17:50 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) client-ip=208.118.235.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=gmail.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) by mx.zohomail.com with SMTPS id 1539846928896810.1513065066894; Thu, 18 Oct 2018 00:15:28 -0700 (PDT) Received: from localhost ([::1]:40602 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gD2Wl-0005Fo-Mj for importer@patchew.org; Thu, 18 Oct 2018 03:15:27 -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) 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) 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) 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+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZohoMail: RDMRC_1 RDKM_2 RSF_0 Z_629925259 SPT_0 Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" 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) =20 DEF("rtc", HAS_ARG, QEMU_OPTION_rtc, \ - "-rtc [base=3Dutc|localtime|date][,clock=3Dhost|rt|vm][,driftfix=3Dnon= e|slew]\n" \ + "-rtc [base=3Dutc|localtime|][,clock=3Dhost|rt|vm][,driftfix= =3Dnone|slew]\n" \ " set the RTC base and clock, enable drift fix for cloc= k ticks (x86 only)\n", QEMU_ARCH_ALL) =20 STEXI =20 -@item -rtc [base=3Dutc|localtime|@var{date}][,clock=3Dhost|vm][,driftfix= =3Dnone|slew] +@item -rtc [base=3Dutc|localtime|@var{datetime}][,clock=3Dhost|rt|vm][,dri= ftfix=3Dnone|slew] @findex -rtc Specify @option{base} as @code{utc} or @code{localtime} to let the RTC sta= rt 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{date= time} in the format @code{2006-06-17T16:01:21} or @code{2006-06-17}. The default base i= s UTC. =20 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{c= lock} -to @code{rt} instead. To even prevent it from progressing during suspensi= on, -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 sl= eeping +is off, and no synchronization algorithm is active. =20 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 --=20 2.7.4