From patchwork Wed Oct 17 12:23:00 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Artem Pisarenko X-Patchwork-Id: 10645397 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 3B05A109C for ; Wed, 17 Oct 2018 12:26:22 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 2FDA72AEDD for ; Wed, 17 Oct 2018 12:26:22 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 23DA72AF00; Wed, 17 Oct 2018 12:26:22 +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 B573F2AED8 for ; Wed, 17 Oct 2018 12:26:21 +0000 (UTC) Received: from localhost ([::1]:36338 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gCku4-0003jE-TA for patchwork-qemu-devel@patchwork.kernel.org; Wed, 17 Oct 2018 08:26:20 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:41269) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gCksa-0002X5-92 for qemu-devel@nongnu.org; Wed, 17 Oct 2018 08:24:49 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gCksW-00070L-EB for qemu-devel@nongnu.org; Wed, 17 Oct 2018 08:24:48 -0400 Received: from mail-lj1-x241.google.com ([2a00:1450:4864:20::241]:42512) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gCksW-0006yK-0Q for qemu-devel@nongnu.org; Wed, 17 Oct 2018 08:24:44 -0400 Received: by mail-lj1-x241.google.com with SMTP id y71-v6so24115913lje.9 for ; Wed, 17 Oct 2018 05:24:42 -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=gzWDSZUzWgGXQ9uuXM46zuT9yZpYXYodmEukxQ4Glsw=; b=Sx6LJibwSXFczntTNw6wERlVsyIrkn8BgTOP4SazEGTzAeCtn2R0mMPan12n7juFPC yrx8eB6U4eU0wtamPI+C0C01TPAjCCSPpbnvkbG/ZYoDpE19z68fnS3o1wgZ3+cU3Hhj 1SPxjwKNi6FSGWW9LCa3lFgjD/EhjkZ9dIuk7tQU6d156bt7lvzPBipJP+4Cidv8gKp1 aQGhVFf3I72JfFsdWy253NsENglSOTXWmPAhazu6orwetwHTz4E0n1JTi+3QRP14DHTT POgr4v1k7vz+SdKypS9vE0xwFD9b/8dqkR1EEl+LbkiF+MebaxvkKfuR2XziAJR2ZJ6t N1pg== 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=gzWDSZUzWgGXQ9uuXM46zuT9yZpYXYodmEukxQ4Glsw=; b=hgpz/AFcYPeIBgFOwMon12v8NmfFn1mpbbLIUpZ9u9V8qFFMTY3eiafWRGc26UB3pc pxGUemHrKNQvovAV8JjosTQRKT2aYiIJZfR3dS6Zi0eRkN4t1mo91Gj4VHxlRzvSYgnA v4EMlXCx0I3NtZTvk1nWM0Xh66a1ccrZkPDL0PTqf14pfgyzLJD48gUrmn3s8WDwpVLk 5AH0T4kMzC7Ffv/VuOYHA1usCBanpl2Zi/2V644Po74iIVUZDkn16MWmaEi/8rS4vyhW r+FLMlcuy1BGJivSsEUZ4Cv94J8OsdDH2YaIM/zHlaj5EMQOcb/rK8y8U0MXRbg5aSrW lhTg== X-Gm-Message-State: ABuFfojY6xfHm1WTQQWuNBrU/8vrcF25rc23BTcWfDMWnh8LfTb5/nA+ DcPmt5KMl3lOzGEEkJ2Uskhm/P+npbo= X-Google-Smtp-Source: ACcGV62UXBsXP1mnyIJhno4Qqeyksdlrw/PTaD5fq8g6uTJVL7uwsf0f08dyUcXSosxteYPR/AwmEA== X-Received: by 2002:a2e:9615:: with SMTP id v21-v6mr16662831ljh.150.1539779081344; Wed, 17 Oct 2018 05:24:41 -0700 (PDT) Received: from localhost.localdomain ([77.221.221.49]) by smtp.gmail.com with ESMTPSA id z67-v6sm3704118lfa.14.2018.10.17.05.24.40 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 17 Oct 2018 05:24:40 -0700 (PDT) From: Artem Pisarenko To: qemu-devel@nongnu.org Date: Wed, 17 Oct 2018 18:23:00 +0600 Message-Id: <4088cc0a4affe3d68a3280013370fc9027fa6ccc.1539778764.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 v2 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