From nobody Mon May 6 04:37:53 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1600964346; cv=none; d=zohomail.com; s=zohoarc; b=NLfp5Nbgswa1BQ7ZxnqOt4zqnlwSYQpOfYwsOhyzNw1EV8WLwQMJf9Kew5rzFuQDr19YpFHpZfwGYim0cuRgNek2ksNvMD2vFhCieBgo3vgeFP7qSycwLTOgJCeRCMon1GHPIP4kMqwNh1i9iZxTOdout4gP1HyKVJi+vkCfLaQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1600964346; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=oGS+wlzbu/ypFu2npSAshgwOPT7LNmtreOSMO2qKE9E=; b=ltWo81ef2okbSt9tMiaiuGF3duUYOM02Na3kAr+CE9JKP1nqTU6T4M2UTkcvNdEDeoPd7VMha6yhSlyFongrHVLOeHRQ6CqEHZpPMsStT72UlAIU2HZhX+dS0zPRMkPkqDN47kKQNvO0KIM/GNFfbTfKU7pPwXhMi1HNcm84KRg= ARC-Authentication-Results: i=1; mx.zohomail.com; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1600964346209162.83362791522882; Thu, 24 Sep 2020 09:19:06 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-13-Jk4IhoHSNbWBYdcY2Rzt7Q-1; Thu, 24 Sep 2020 12:19:02 -0400 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id C1DF32FD03; Thu, 24 Sep 2020 16:18:55 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 9FDAA5D9D3; Thu, 24 Sep 2020 16:18:53 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id A86521826D2B; Thu, 24 Sep 2020 16:18:51 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 08OGIoHA015483 for ; Thu, 24 Sep 2020 12:18:50 -0400 Received: by smtp.corp.redhat.com (Postfix) id 925442028DCC; Thu, 24 Sep 2020 16:18:50 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast01.extmail.prod.ext.rdu2.redhat.com [10.11.55.17]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 8DAFA2028DC0 for ; Thu, 24 Sep 2020 16:18:48 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 3A600858287 for ; Thu, 24 Sep 2020 16:18:48 +0000 (UTC) Received: from mail-lj1-f196.google.com (mail-lj1-f196.google.com [209.85.208.196]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-573-gB7EDp7iOP2_FwKWaPMFGA-1; Thu, 24 Sep 2020 12:18:45 -0400 Received: by mail-lj1-f196.google.com with SMTP id y4so3244707ljk.8 for ; Thu, 24 Sep 2020 09:18:45 -0700 (PDT) Received: from kloomba.my.domain ([5.227.242.255]) by smtp.gmail.com with ESMTPSA id b14sm2418280lfp.176.2020.09.24.09.18.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 24 Sep 2020 09:18:42 -0700 (PDT) X-MC-Unique: Jk4IhoHSNbWBYdcY2Rzt7Q-1 X-MC-Unique: gB7EDp7iOP2_FwKWaPMFGA-1 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:mime-version :content-transfer-encoding; bh=oGS+wlzbu/ypFu2npSAshgwOPT7LNmtreOSMO2qKE9E=; b=qzP3gEBhLBwbNWnE21K82P49Apl9egEw/xXtrhFo9jEghec2KYlOCavFjlsABTod76 va72T7ez0+2JKkabHIib+iPbam04bmvbgJJZFWrudS9hPBQRq7DQhhYiGyXUUzfF2f+x C0BYNjLa/FK4ynehXYGnHz2AJCesU4EaEZmljzxlfPRYW7gGAoU7+5YPb3f+Vk0IMQY5 cEmxgWKDaytcK1H6epWezGI+PCtGE+XmeARvIDNyPXRB5hZExlFVvG5R0TSbGBRmM8/N Od93ah9TT7bGfK/s9aGS56Mp2+IVERXeuPLmCOkYxemVzOrsFWAwL4qa8vYoU4EljZHJ U7yA== X-Gm-Message-State: AOAM531QPLcLDAUeS5a8ohssndNJsOQ3b6Xb8PV5MNYiMBkIuqAftXgB DO4nP22EU05pH0sK0yvnz+zTCpCdGtTpGboT X-Google-Smtp-Source: ABdhPJxtUkvYv37nlIvL3ExNeXx6DOUcKy5Ive+j4YBiHe81kvkf55T5s0pRhs+/9Qt101dSgeXRCA== X-Received: by 2002:a2e:9943:: with SMTP id r3mr180928ljj.342.1600964323636; Thu, 24 Sep 2020 09:18:43 -0700 (PDT) From: Roman Bogorodskiy To: libvir-list@redhat.com Subject: [PATCH] docs: bhyve: document sound device and VNC bits Date: Thu, 24 Sep 2020 20:18:28 +0400 Message-Id: <20200924161828.15010-1-bogorodskiy@gmail.com> MIME-Version: 1.0 X-Mimecast-Impersonation-Protect: Policy=CLT - Impersonation Protection Definition; Similar Internal Domain=false; Similar Monitored External Domain=false; Custom External Domain=false; Mimecast External Domain=false; Newly Observed Domain=false; Internal User Name=false; Custom Display Name List=false; Reply-to Address Mismatch=false; Targeted Threat Dictionary=false; Mimecast Threat Dictionary=false; Custom Threat Dictionary=false X-Scanned-By: MIMEDefang 2.78 on 10.11.54.4 X-loop: libvir-list@redhat.com Cc: Roman Bogorodskiy X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" * Document sound device support, * Document VNC password configuration and framebuffer resolution. Signed-off-by: Roman Bogorodskiy --- docs/drvbhyve.html.in | 47 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/docs/drvbhyve.html.in b/docs/drvbhyve.html.in index ca511eeccd..cffb63f1ad 100644 --- a/docs/drvbhyve.html.in +++ b/docs/drvbhyve.html.in @@ -389,6 +389,30 @@ it with the port attribute):

<graphics type=3D'vnc' autoport=3D'yes'> =20 +

Since 6.8.0, it's possible to set framebuf= fer resolution +using the resolution sub-element:

+ +
+   <video>
+     <model type=3D'gop' heads=3D'1' primary=3D'yes'>
+       <resolution x=3D'800' y=3D'600'/>
+     </model>
+   </video>
+
+ +

Since 6.8.0, VNC server can be configured = to use +password based authentication:

+ +
+  <graphics type=3D'vnc' port=3D'5904' passwd=3D'foobar'>
+    <listen type=3D'address' address=3D'127.0.0.1'/>
+  </graphics>
+
+ +

Note: VNC password authentication is known to be cryptographically weak. +Additionally, the password is passed as a command line argument in clear t= ext. +Make sure you understand the risks associated with this feature before usi= ng it.

+

Clock configuration

=20

Originally bhyve supported only localtime for RTC. Support for UTC time= was introduced in @@ -432,6 +456,29 @@ supports Intel e1000 network adapter emulation. It's s= upported in libvirt ... =20 +

Sound device

+ +

As of r349= 355 bhyve +supports sound device emulation. It's supported in libvirt +since 6.7.0.

+ +
+...
+  <sound model=3D'ich7'>
+    <audio id=3D'1'/>
+  </sound>
+  <audio id=3D'1' type=3D'oss'>
+    <input dev=3D'/dev/dsp0'/>
+    <output dev=3D'/dev/dsp0'/>
+  </audio>
+...
+
+ +

Here, the sound element specifies the sound device as it's= exposed +to the guest, with ich7 being the only supported model now, +and the audio element specifies how the guest device is mapped +to the host sound device.

+

Wiring guest memory

=20

Since 4.4.0, it's possible to specify that= guest memory should --=20 2.27.0