From nobody Sat Jun 1 14:36:09 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1589555897; cv=none; d=zohomail.com; s=zohoarc; b=mB5w4s8W0o0EjakC1PLXM21exK99mO4L9YQ7ioBodEuqALdgSKxMDBMxr+KIAs9LIKzQeQyj9PJTXd4hJ32Rj+i2inEgsvLcNeosww554u6uCV94XpFn0ervEFErms3CZVxaXyjDWmZGwCAq/uTrm1k77ZV1grzKMmPI3BQ/I/Y= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1589555897; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=zfjuT4LY+VaWUB8rPtCcPetLXEZKyEWaB1/4ZEsB1Gc=; b=N5B3AEHMzduIDzokYTIPtrIuhgIO+pCt21W5iWxv+IAIymYVSWY80+NRs1qfnVdRRhntl1TYNRDhqaYw3A/Ik4gH+23AjwkbD7RU/kpWQMy/aDhuBenuyNSiDQLCklLZOW3KdEaNJQy7P34h6gY7B6G9Os1hhF6OCXaz1S/1Wl0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1589555897745459.7584818253832; Fri, 15 May 2020 08:18:17 -0700 (PDT) Received: from localhost ([::1]:58288 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jZc6K-0000Fs-Ew for importer@patchew.org; Fri, 15 May 2020 11:18:16 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50298) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jZc3f-000403-Ne for qemu-devel@nongnu.org; Fri, 15 May 2020 11:15:31 -0400 Received: from us-smtp-1.mimecast.com ([205.139.110.61]:20509 helo=us-smtp-delivery-1.mimecast.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1jZc3e-0005x8-9v for qemu-devel@nongnu.org; Fri, 15 May 2020 11:15:31 -0400 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-218-CdPyugUVN4i2tNkGPdtP-g-1; Fri, 15 May 2020 11:15:27 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 4AAD453; Fri, 15 May 2020 15:15:26 +0000 (UTC) Received: from localhost (ovpn-112-229.ams2.redhat.com [10.36.112.229]) by smtp.corp.redhat.com (Postfix) with ESMTPS id D87691001B07; Fri, 15 May 2020 15:15:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1589555729; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=zfjuT4LY+VaWUB8rPtCcPetLXEZKyEWaB1/4ZEsB1Gc=; b=QVPrz1/74U7pp704WCzMkDGKIQNnYqIbnqIN2W5Y8xQg+yv0kcJYLThhEpT+bWx+LCWOvY 0IueGKqs09iIePFXZ6ldVqnzIbJvwLvCqKiD0YMFcnLmOLW5qAOWIlSqrBhSOLX0+qXlf5 WgiyjAhgjNqBVYofRVGBf/hbJK8fJJw= X-MC-Unique: CdPyugUVN4i2tNkGPdtP-g-1 From: Cornelia Huck To: qemu-s390x@nongnu.org Subject: [PATCH v2 1/3] docs/s390x: document the virtual css Date: Fri, 15 May 2020 17:15:16 +0200 Message-Id: <20200515151518.83950-2-cohuck@redhat.com> In-Reply-To: <20200515151518.83950-1-cohuck@redhat.com> References: <20200515151518.83950-1-cohuck@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=205.139.110.61; envelope-from=cohuck@redhat.com; helo=us-smtp-delivery-1.mimecast.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/15 00:07:24 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Cornelia Huck , qemu-devel@nongnu.org Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Type: text/plain; charset="utf-8" Add some hints about "devno" rules. Signed-off-by: Cornelia Huck Reviewed-by: Thomas Huth --- docs/system/s390x/css.rst | 86 ++++++++++++++++++++++++++++++++++++ docs/system/target-s390x.rst | 1 + 2 files changed, 87 insertions(+) create mode 100644 docs/system/s390x/css.rst diff --git a/docs/system/s390x/css.rst b/docs/system/s390x/css.rst new file mode 100644 index 000000000000..9e472b7813ec --- /dev/null +++ b/docs/system/s390x/css.rst @@ -0,0 +1,86 @@ +The virtual channel subsystem +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D + +QEMU implements a virtual channel subsystem with subchannels, (mostly +functionless) channel paths, and channel devices (virtio-ccw, 3270, and +devices passed via vfio-ccw). It supports multiple subchannel sets (MSS) a= nd +multiple channel subsystems extended (MCSS-E). + +All channel devices support the ``devno`` property, which takes a parameter +in the form ``..``. + +The default channel subsystem image id (````) is ``0xfe``. Devices = in +there will show up in channel subsystem image ``0`` to guests that do not +enable MCSS-E. Note that devices with a different cssid will not be visible +if the guest OS does not enable MCSS-E (which is true of all supported gue= st +operating systems today). + +Supported values for the subchannel set id (````) range from ``0-3``. +Devices with a ssid that is not ``0`` will not be visible if the guest OS +does not enable MSS (any Linux version that supports virtio also enables M= SS). +Any device may be put into any subchannel set, there is no restriction by +device type. + +The device number can range from ``0-0xffff``. + +If the ``devno`` property is not specified for a device, QEMU will choose = the +next free device number in subchannel set 0, skipping to the next subchann= el +set if no more device numbers are free. + +QEMU places a device at the first free subchannel in the specified subchan= nel +set. If a device is hotunplugged and later replugged, it may appear at a +different subchannel. (This is similar to how z/VM works.) + + +Examples +-------- + +* a virtio-net device, cssid/ssid/devno automatically assigned:: + + -device virtio-net-ccw + + In a Linux guest (without default devices and no other devices specified + prior to this one), this will show up as ``0.0.0000`` under subchannel + ``0.0.0000``. + + The auto-assigned-properties in QEMU (as seen via e.g. ``info qtree``) + would be ``dev_id =3D "fe.0.0000"`` and ``subch_id =3D "fe.0.0000"``. + +* a virtio-rng device in subchannel set ``0``:: + + -device virtio-rng-ccw,devno=3Dfe.0.0042 + + If added to the same Linux guest as above, it would show up as ``0.0.004= 2`` + under subchannel ``0.0.0001``. + + The properties for the device would be ``dev_id =3D "fe.0.0042"`` and + ``subch_id =3D "fe.0.0001"``. + +* a virtio-gpu device in subchannel set ``2``:: + + -device virtio-gpu-ccw,devno=3Dfe.2.1111 + + If added to the same Linux guest as above, it would show up as ``0.2.111= 1`` + under subchannel ``0.2.0000``. + + The properties for the device would be ``dev_id =3D "fe.2.1111"`` and + ``subch_id =3D "fe.2.0000"``. + +* a virtio-mouse device in a non-standard channel subsystem image:: + + -device virtio-mouse-ccw,devno=3D2.0.2222 + + This would not show up in a standard Linux guest. + + The properties for the device would be ``dev_id =3D "2.0.2222"`` and + ``subch_id =3D "2.0.0000"``. + +* a virtio-keyboard device in another non-standard channel subsystem image= :: + + -device virtio-keyboard-ccw,devno=3D0.0.1234 + + This would not show up in a standard Linux guest, either, as ``0`` is not + the standard channel subsystem image id. + + The properties for the device would be ``dev_id =3D "0.0.1234"`` and + ``subch_id =3D "0.0.0000"``. diff --git a/docs/system/target-s390x.rst b/docs/system/target-s390x.rst index 7d76ae97b401..37ca032d98ef 100644 --- a/docs/system/target-s390x.rst +++ b/docs/system/target-s390x.rst @@ -23,6 +23,7 @@ or vfio-ap is also available. =20 .. toctree:: s390x/vfio-ap + s390x/css =20 Architectural features =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.25.4 From nobody Sat Jun 1 14:36:09 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1589556021; cv=none; d=zohomail.com; s=zohoarc; b=Wl9m/uKnBBM7xCS1pFyPkS1a9zsAjHPTQJBdWEL1Z4SkV1UWzEJkROGP2m5GSWFQ1aT2JzSWbulIT8eGWMEroMk74UEhITXcEAdE/I4s9fiJE2VGKOKV1hAp7A6nCje1mmosXmCyi8u7RQKjhzq0JzC2JiOCocdEm1zSiYqY+Y8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1589556021; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=OAWpXPVrCEG5F/afepxStBicmskD8vkqj4cMNRvSFV8=; b=JmttGzeroMK2lojqonN7/xMsl1FNvMLBEXJ06d92mMju88pKKIt5xN16bQHcPrOHBpyOsL2zzDcRmwACb1hJP6Fuw/0vEEZMQ9u3IJSIcO0cvbHdJy4vuxjpGi7MQfWBpAq4pbeGzute81xq7wWB3sKkTqbJ6rY5ixwL7ycKktg= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1589556021860171.783661772934; Fri, 15 May 2020 08:20:21 -0700 (PDT) Received: from localhost ([::1]:35858 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jZc8K-00036Z-Lj for importer@patchew.org; Fri, 15 May 2020 11:20:20 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50306) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jZc3g-00042Y-Ic for qemu-devel@nongnu.org; Fri, 15 May 2020 11:15:32 -0400 Received: from us-smtp-delivery-1.mimecast.com ([205.139.110.120]:25282 helo=us-smtp-1.mimecast.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1jZc3f-0005xm-Mq for qemu-devel@nongnu.org; Fri, 15 May 2020 11:15:32 -0400 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-360-cBaukAU4N5iq8_j-Lmioqw-1; Fri, 15 May 2020 11:15:29 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 68E65800053; Fri, 15 May 2020 15:15:28 +0000 (UTC) Received: from localhost (ovpn-112-229.ams2.redhat.com [10.36.112.229]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 0BFDF2E17A; Fri, 15 May 2020 15:15:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1589555730; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=OAWpXPVrCEG5F/afepxStBicmskD8vkqj4cMNRvSFV8=; b=JzwBWA1uBkbzUuWsAzM5uvHnSPAiUi99ptRvRmjAXoQHIMyahuH8gYTJ1Tr9NCHk4J1U4s 8bC9rm4NLP/RBTKRIOn+Irep1GcZDS0ju5Da8ZmmZ4vmyvm8NwU+u6O0Rw3mYvwLPnKnJT gS4dJrIrtTy6nqfnlwnPj+bi5mQvJNY= X-MC-Unique: cBaukAU4N5iq8_j-Lmioqw-1 From: Cornelia Huck To: qemu-s390x@nongnu.org Subject: [PATCH v2 2/3] docs/s390x: document 3270 Date: Fri, 15 May 2020 17:15:17 +0200 Message-Id: <20200515151518.83950-3-cohuck@redhat.com> In-Reply-To: <20200515151518.83950-1-cohuck@redhat.com> References: <20200515151518.83950-1-cohuck@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=205.139.110.120; envelope-from=cohuck@redhat.com; helo=us-smtp-1.mimecast.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/14 23:27:07 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Cornelia Huck , qemu-devel@nongnu.org Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Type: text/plain; charset="utf-8" Add some basic info how to use 3270 devices. Signed-off-by: Cornelia Huck Reviewed-by: Thomas Huth --- docs/system/s390x/3270.rst | 32 ++++++++++++++++++++++++++++++++ docs/system/target-s390x.rst | 1 + 2 files changed, 33 insertions(+) create mode 100644 docs/system/s390x/3270.rst diff --git a/docs/system/s390x/3270.rst b/docs/system/s390x/3270.rst new file mode 100644 index 000000000000..1774cdcadf01 --- /dev/null +++ b/docs/system/s390x/3270.rst @@ -0,0 +1,32 @@ +3270 devices +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +QEMU supports connecting an external 3270 terminal emulator (such as +``x3270``) to make a single 3270 device available to a guest. Note that th= is +supports basic features only. + +To provide a 3270 device to a guest, create a ``x-terminal3270`` linked to +a ``tn3270`` chardev. The guest will see a 3270 channel device. In order +to actually be able to use it, attach the ``x3270`` emulator to the charde= v. + +Example configuration +--------------------- + +* Add a ``tn3270`` chardev and a ``x-terminal3270`` to the QEMU command li= ne:: + + -chardev socket,id=3Dchar_0,host=3D0.0.0.0,port=3D2300,nowait,server,t= n3270 + -device x-terminal3270,chardev=3Dchar_0,devno=3Dfe.0.000a,id=3Dtermina= l_0 + +* Start the guest. In the guest, use ``chccwdev -e 0.0.000a`` to enable + the device. + +* On the host, start the ``x3270`` emulator:: + + x3270 :2300 + +* In the guest, locate the 3270 device node under ``/dev/3270/`` (say, + ``tty1``) and start a getty on it:: + + systemctl start serial-getty@3270-tty1.service + +This should get you an addtional tty for logging into the guest. diff --git a/docs/system/target-s390x.rst b/docs/system/target-s390x.rst index 37ca032d98ef..2592a05303ef 100644 --- a/docs/system/target-s390x.rst +++ b/docs/system/target-s390x.rst @@ -24,6 +24,7 @@ or vfio-ap is also available. .. toctree:: s390x/vfio-ap s390x/css + s390x/3270 =20 Architectural features =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.25.4 From nobody Sat Jun 1 14:36:09 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1589555811; cv=none; d=zohomail.com; s=zohoarc; b=n02RArwoblwPgOV7Oe8+cWGKComry75Yjulw0qQB4EgrGhVQqAmerZVzAQwjGXcroMXRAYlDwAvkwWE0mZH8U1IJZi1SWTQF8j3xBRjxM1NKb2tclW8pRkEsUUp//VOjXrCrzdgEumBjQ0AaV+zPAcaqSl0dy2bicTYJ5yDegek= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1589555811; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=6pddmoRnqZoHNeMB0r0PyY5bEn79vipDG8JOISd/tkc=; b=hDhdLeIyXrU3AiPmqv2HDSxWyPJm59nzI159hsg9Bttdb4DAiEKX0pyh+70Y15gcm+uxzqUoZ45RFhvbJc93ulwi7G3tfnN7Uq4/j5di3YcZV+KT4cUUeAf8kGj7bjnzNyPid7sbH3im/9Jg/AwlImIMX4kN+ANm7/OgEvsWP8I= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1589555811361102.0882070039487; Fri, 15 May 2020 08:16:51 -0700 (PDT) Received: from localhost ([::1]:53118 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jZc4w-0005pE-Hp for importer@patchew.org; Fri, 15 May 2020 11:16:50 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50326) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jZc3k-0004AV-1J for qemu-devel@nongnu.org; Fri, 15 May 2020 11:15:36 -0400 Received: from us-smtp-delivery-1.mimecast.com ([207.211.31.120]:56587 helo=us-smtp-1.mimecast.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1jZc3i-0005za-FP for qemu-devel@nongnu.org; Fri, 15 May 2020 11:15:35 -0400 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-145-sD3zGBhyOdOS50vKX5ha2Q-1; Fri, 15 May 2020 11:15:31 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id DBEF68735C8; Fri, 15 May 2020 15:15:30 +0000 (UTC) Received: from localhost (ovpn-112-229.ams2.redhat.com [10.36.112.229]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 420E06E9E5; Fri, 15 May 2020 15:15:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1589555733; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=6pddmoRnqZoHNeMB0r0PyY5bEn79vipDG8JOISd/tkc=; b=HdyJytwuilSXYazWi6lzCdMm3YMh+5MFfWDcs4HZCXKhUVRkxHomos7WBUsDZRIU3TDa6z JCZ27lrSgskjzbgyprSAepmaOCYQJr1r5q3mwpb0tE1d3tuFzs52VHXof/WkyPxFlVwOBo YeXYQrwsT/4BXCBlOvKXKpWMqLUqcuc= X-MC-Unique: sD3zGBhyOdOS50vKX5ha2Q-1 From: Cornelia Huck To: qemu-s390x@nongnu.org Subject: [PATCH v2 3/3] docs/s390x: document vfio-ccw Date: Fri, 15 May 2020 17:15:18 +0200 Message-Id: <20200515151518.83950-4-cohuck@redhat.com> In-Reply-To: <20200515151518.83950-1-cohuck@redhat.com> References: <20200515151518.83950-1-cohuck@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=207.211.31.120; envelope-from=cohuck@redhat.com; helo=us-smtp-1.mimecast.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/14 22:56:02 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas Huth , Cornelia Huck , qemu-devel@nongnu.org Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Type: text/plain; charset="utf-8" Add a basic example for passing a dasd via vfio-ccw. Signed-off-by: Cornelia Huck --- docs/system/s390x/vfio-ccw.rst | 72 ++++++++++++++++++++++++++++++++++ docs/system/target-s390x.rst | 1 + 2 files changed, 73 insertions(+) create mode 100644 docs/system/s390x/vfio-ccw.rst diff --git a/docs/system/s390x/vfio-ccw.rst b/docs/system/s390x/vfio-ccw.rst new file mode 100644 index 000000000000..4cfd22c3b789 --- /dev/null +++ b/docs/system/s390x/vfio-ccw.rst @@ -0,0 +1,72 @@ +Subchannel passthrough via vfio-ccw +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +vfio-ccw (based upon the mediated vfio device infrastructure) allows to +make certain I/O subchannels and their devices available to a guest. The +host will not interact with those subchannels/devices any more. + +Note that while vfio-ccw should work with most non-QDIO devices, only ECKD +DASDs have really been tested. + +Example configuration +--------------------- + +Step 1: configure the host device +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Note: it is recommended to use the ``mdevctl`` tool for this step. + +To define the same device as configured below to be started +automatically, use + +:: + + [root@host ~]# driverctl -b css set-override 0.0.0313 vfio_ccw + [root@host ~]# mdevctl define -u 7e270a25-e163-4922-af60-757fc8ed48c6\ + -p 0.0.0313 -t vfio-ccw_io -a + +If this is not possible or wanted, follow the manual procedure below. + +* Locate the subchannel for the device (in this example, ``0.0.2b09``):: + + [root@host ~]# lscss | grep 0.0.2b09 | awk '{print $2}' + 0.0.0313 + +* Unbind the subchannel (in this example, ``0.0.0313``) from the standard + I/O subchannel driver and bind it to the vfio-ccw driver:: + + [root@host ~]# echo 0.0.0313 > /sys/bus/css/devices/0.0.0313/driver/un= bind + [root@host ~]# echo 0.0.0313 > /sys/bus/css/drivers/vfio_ccw/bind + +* Create the mediated device (identified by a uuid):: + + [root@host ~]# uuidgen + 7e270a25-e163-4922-af60-757fc8ed48c6 + [root@host ~]# echo "7e270a25-e163-4922-af60-757fc8ed48c6" > \ + /sys/bus/css/devices/0.0.0313/mdev_supported_types/vfio_ccw-io/create + +Step 2: configure QEMU +~~~~~~~~~~~~~~~~~~~~~~ + +* Reference the created mediated device and (optionally) pick a device id = to + be presented in the guest (here, ``fe.0.1234``, which will end up visible + in the guest as ``0.0.1234``:: + + -device vfio-ccw,devno=3Dfe.0.1234,sysfsdev=3D\ + /sys/bus/mdev/devices/7e270a25-e163-4922-af60-757fc8ed48c6 + +* Start the guest. The device (here, ``0.0.1234``) should now be usable:: + + [root@guest ~]# lscss -d 0.0.1234 + Device Subchan. DevType CU Type Use PIM PAM POM CHPIDs =20 + ---------------------------------------------------------------------- + 0.0.1234 0.0.0007 3390/0e 3990/e9 f0 f0 ff 1a2a3a0a 00000000 + [root@guest ~]# chccwdev -e 0.0.1234 + Setting device 0.0.1234 online + Done + [root@guest ~]# dmesg -t + (...) + dasd-eckd 0.0.1234: A channel path to the device has become operational + dasd-eckd 0.0.1234: New DASD 3390/0E (CU 3990/01) with 10017 cylinders= , 15 heads, 224 sectors + dasd-eckd 0.0.1234: DASD with 4 KB/block, 7212240 KB total size, 48 KB= /track, compatible disk layout + dasda:VOL1/ 0X2B09: dasda1 diff --git a/docs/system/target-s390x.rst b/docs/system/target-s390x.rst index 2592a05303ef..644e404ef9fd 100644 --- a/docs/system/target-s390x.rst +++ b/docs/system/target-s390x.rst @@ -25,6 +25,7 @@ or vfio-ap is also available. s390x/vfio-ap s390x/css s390x/3270 + s390x/vfio-ccw =20 Architectural features =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.25.4