diff options
| author | Cornelia Huck <cohuck@redhat.com> | 2020-04-30 13:35:43 +0200 |
|---|---|---|
| committer | Cornelia Huck <cohuck@redhat.com> | 2020-06-05 17:13:11 +0200 |
| commit | 61a3d5eded4af9e4cc8d779672891eba8d94879c (patch) | |
| tree | 5398e940a75f82d757b28420870a191a5e870321 /docs | |
| parent | f31270d4ebc8251ff03e808d0eb6cd6e3bbc1b99 (diff) | |
| download | qemu-61a3d5eded4af9e4cc8d779672891eba8d94879c.zip qemu-61a3d5eded4af9e4cc8d779672891eba8d94879c.tar.gz qemu-61a3d5eded4af9e4cc8d779672891eba8d94879c.tar.bz2 | |
docs/s390x: document 3270
Add some basic info how to use 3270 devices.
Message-Id: <20200515151518.83950-3-cohuck@redhat.com>
Reviewed-by: Thomas Huth <thuth@redhat.com>
Signed-off-by: Cornelia Huck <cohuck@redhat.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/system/s390x/3270.rst | 32 | ||||
| -rw-r--r-- | docs/system/target-s390x.rst | 1 |
2 files changed, 33 insertions, 0 deletions
diff --git a/docs/system/s390x/3270.rst b/docs/system/s390x/3270.rst new file mode 100644 index 0000000..1774cdc --- /dev/null +++ b/docs/system/s390x/3270.rst @@ -0,0 +1,32 @@ +3270 devices +============ + +QEMU supports connecting an external 3270 terminal emulator (such as +``x3270``) to make a single 3270 device available to a guest. Note that this +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 chardev. + +Example configuration +--------------------- + +* Add a ``tn3270`` chardev and a ``x-terminal3270`` to the QEMU command line:: + + -chardev socket,id=char_0,host=0.0.0.0,port=2300,nowait,server,tn3270 + -device x-terminal3270,chardev=char_0,devno=fe.0.000a,id=terminal_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 <host>: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 37ca032..2592a05 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 Architectural features ====================== |