€•…ÿ      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ%/translations/zh_CN/arch/powerpc/hvcs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/zh_TW/arch/powerpc/hvcs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/it_IT/arch/powerpc/hvcs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/ja_JP/arch/powerpc/hvcs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/ko_KR/arch/powerpc/hvcs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/pt_BR/arch/powerpc/hvcs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/sp_SP/arch/powerpc/hvcs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ?HVCS IBM "Hypervisor Virtual Console Server" Installation Guide”h]”hŒCHVCS IBM â€œHypervisor Virtual Console Serverâ€ Installation Guide”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³Œ?/var/lib/git/docbuild/linux/Documentation/arch/powerpc/hvcs.rst”h´KubhŒ	paragraph”“”)”}”(hŒfor Linux Kernel 2.6.4+”h]”hŒfor Linux Kernel 2.6.4+”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒ"Copyright (C) 2004 IBM Corporation”h]”hŒ"Copyright (C) 2004 IBM Corporation”…””}”(hhÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhŒcomment”“”)”}”(hŒK===========================================================================”h]”hŒK===========================================================================”…””}”hhësbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1héhh·h²hh³hÊh´K	ubhê)”}”(hŒKNOTE:Eight space tabs are the optimum editor setting for reading this file.”h]”hŒKNOTE:Eight space tabs are the optimum editor setting for reading this file.”…””}”hhûsbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1héhh·h²hh³hÊh´K
ubhê)”}”(hŒK===========================================================================”h]”hŒK===========================================================================”…””}”hj	  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1héhh·h²hh³hÊh´KubhÌ)”}”(hŒ*Author(s): Ryan S. Arnold <rsa@us.ibm.com>”h]”(hŒAuthor(s): Ryan S. Arnold <”…””}”(hj  h²hh³Nh´NubhŒ	reference”“”)”}”(hŒrsa@us.ibm.com”h]”hŒrsa@us.ibm.com”…””}”(hj!  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:rsa@us.ibm.com”uh1j  hj  ubhŒ>”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒ<Date Created: March, 02, 2004
Last Changed: August, 24, 2004”h]”hŒ<Date Created: March, 02, 2004
Last Changed: August, 24, 2004”…””}”(hj;  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhê)”}”(hŒøTable of contents:

1.  Driver Introduction:
2.  System Requirements
3.  Build Options:
        3.1  Built-in:
        3.2  Module:
4.  Installation:
5.  Connection:
6.  Disconnection:
7.  Configuration:
8.  Questions & Answers:
9.  Reporting Bugs:”h]”hŒøTable of contents:

1.  Driver Introduction:
2.  System Requirements
3.  Build Options:
        3.1  Built-in:
        3.2  Module:
4.  Installation:
5.  Connection:
6.  Disconnection:
7.  Configuration:
8.  Questions & Answers:
9.  Reporting Bugs:”…””}”hjI  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1héhh·h²hh³hÊh´K ubh¶)”}”(hhh]”(h»)”}”(hŒ1. Driver Introduction:”h]”hŒ1. Driver Introduction:”…””}”(hjZ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjW  h²hh³hÊh´K"ubhÌ)”}”(hXæ  This is the device driver for the IBM Hypervisor Virtual Console Server,
"hvcs".  The IBM hvcs provides a tty driver interface to allow Linux user
space applications access to the system consoles of logically partitioned
operating systems (Linux and AIX) running on the same partitioned Power5
ppc64 system.  Physical hardware consoles per partition are not practical
on this hardware so system consoles are accessed by this driver using
firmware interfaces to virtual terminal devices.”h]”hXê  This is the device driver for the IBM Hypervisor Virtual Console Server,
â€œhvcsâ€.  The IBM hvcs provides a tty driver interface to allow Linux user
space applications access to the system consoles of logically partitioned
operating systems (Linux and AIX) running on the same partitioned Power5
ppc64 system.  Physical hardware consoles per partition are not practical
on this hardware so system consoles are accessed by this driver using
firmware interfaces to virtual terminal devices.”…””}”(hjh  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K$hjW  h²hubeh}”(h]”Œdriver-introduction”ah ]”h"]”Œ1. driver introduction:”ah$]”h&]”uh1hµhh·h²hh³hÊh´K"ubh¶)”}”(hhh]”(h»)”}”(hŒ2. System Requirements:”h]”hŒ2. System Requirements:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj~  h²hh³hÊh´K-ubhÌ)”}”(hŒ}This device driver was written using 2.6.4 Linux kernel APIs and will only
build and run on kernels of this version or later.”h]”hŒ}This device driver was written using 2.6.4 Linux kernel APIs and will only
build and run on kernels of this version or later.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K/hj~  h²hubhÌ)”}”(hŒ­This driver was written to operate solely on IBM Power5 ppc64 hardware
though some care was taken to abstract the architecture dependent firmware
calls from the driver code.”h]”hŒ­This driver was written to operate solely on IBM Power5 ppc64 hardware
though some care was taken to abstract the architecture dependent firmware
calls from the driver code.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K2hj~  h²hubhÌ)”}”(hŒÌSysfs must be mounted on the system so that the user can determine which
major and minor numbers are associated with each vty-server.  Directions
for sysfs mounting are outside the scope of this document.”h]”hŒÌSysfs must be mounted on the system so that the user can determine which
major and minor numbers are associated with each vty-server.  Directions
for sysfs mounting are outside the scope of this document.”…””}”(hj«  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K6hj~  h²hubeh}”(h]”Œsystem-requirements”ah ]”h"]”Œ2. system requirements:”ah$]”h&]”uh1hµhh·h²hh³hÊh´K-ubh¶)”}”(hhh]”(h»)”}”(hŒ3. Build Options:”h]”hŒ3. Build Options:”…””}”(hjÄ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÁ  h²hh³hÊh´K;ubhÌ)”}”(hX$  The hvcs driver registers itself as a tty driver.  The tty layer
dynamically allocates a block of major and minor numbers in a quantity
requested by the registering driver.  The hvcs driver asks the tty layer
for 64 of these major/minor numbers by default to use for hvcs device node
entries.”h]”hX$  The hvcs driver registers itself as a tty driver.  The tty layer
dynamically allocates a block of major and minor numbers in a quantity
requested by the registering driver.  The hvcs driver asks the tty layer
for 64 of these major/minor numbers by default to use for hvcs device node
entries.”…””}”(hjÒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K=hjÁ  h²hubhÌ)”}”(hŒÆIf the default number of device entries is adequate then this driver can be
built into the kernel.  If not, the default can be over-ridden by inserting
the driver as a module with insmod parameters.”h]”hŒÆIf the default number of device entries is adequate then this driver can be
built into the kernel.  If not, the default can be over-ridden by inserting
the driver as a module with insmod parameters.”…””}”(hjà  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KChjÁ  h²hubh¶)”}”(hhh]”(h»)”}”(hŒ3.1 Built-in:”h]”hŒ3.1 Built-in:”…””}”(hjñ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjî  h²hh³hÊh´KHubhÌ)”}”(hŒ^The following menuconfig example demonstrates selecting to build this
driver into the kernel::”h]”hŒ]The following menuconfig example demonstrates selecting to build this
driver into the kernel:”…””}”(hjÿ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KJhjî  h²hubhŒliteral_block”“”)”}”(hŒvDevice Drivers  --->
        Character devices  --->
                <*> IBM Hypervisor Virtual Console Server Support”h]”hŒvDevice Drivers  --->
        Character devices  --->
                <*> IBM Hypervisor Virtual Console Server Support”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´KMhjî  h²hubhÌ)”}”(hŒBegin the kernel make process.”h]”hŒBegin the kernel make process.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KQhjî  h²hubeh}”(h]”Œbuilt-in”ah ]”h"]”Œ3.1 built-in:”ah$]”h&]”uh1hµhjÁ  h²hh³hÊh´KHubh¶)”}”(hhh]”(h»)”}”(hŒ3.2 Module:”h]”hŒ3.2 Module:”…””}”(hj6  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj3  h²hh³hÊh´KTubhÌ)”}”(hŒaThe following menuconfig example demonstrates selecting to build this
driver as a kernel module::”h]”hŒ`The following menuconfig example demonstrates selecting to build this
driver as a kernel module:”…””}”(hjD  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KVhj3  h²hubj  )”}”(hŒvDevice Drivers  --->
        Character devices  --->
                <M> IBM Hypervisor Virtual Console Server Support”h]”hŒvDevice Drivers  --->
        Character devices  --->
                <M> IBM Hypervisor Virtual Console Server Support”…””}”hjR  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´KYhj3  h²hubhÌ)”}”(hŒ9The make process will build the following kernel modules:”h]”hŒ9The make process will build the following kernel modules:”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K]hj3  h²hubhŒblock_quote”“”)”}”(hŒ- hvcs.ko
- hvcserver.ko
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒhvcs.ko”h]”hÌ)”}”(hj}  h]”hŒhvcs.ko”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K_hj{  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jy  hjv  ubjz  )”}”(hŒhvcserver.ko
”h]”hÌ)”}”(hŒhvcserver.ko”h]”hŒhvcserver.ko”…””}”(hj–  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K`hj’  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jy  hjv  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jt  h³hÊh´K_hjp  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jn  h³hÊh´K_hj3  h²hubhÌ)”}”(hŒjTo insert the module with the default allocation execute the following
commands in the order they appear::”h]”hŒiTo insert the module with the default allocation execute the following
commands in the order they appear:”…””}”(hj¸  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kbhj3  h²hubj  )”}”(hŒ"insmod hvcserver.ko
insmod hvcs.ko”h]”hŒ"insmod hvcserver.ko
insmod hvcs.ko”…””}”hjÆ  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´Kehj3  h²hubhÌ)”}”(hŒ¦The hvcserver module contains architecture specific firmware calls and must
be inserted first, otherwise the hvcs module will not find some of the
symbols it expects.”h]”hŒ¦The hvcserver module contains architecture specific firmware calls and must
be inserted first, otherwise the hvcs module will not find some of the
symbols it expects.”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khhj3  h²hubhÌ)”}”(hŒeTo override the default use an insmod parameter as follows (requesting 4
tty devices as an example)::”h]”hŒdTo override the default use an insmod parameter as follows (requesting 4
tty devices as an example):”…””}”(hjâ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Klhj3  h²hubj  )”}”(hŒ#insmod hvcs.ko hvcs_parm_num_devs=4”h]”hŒ#insmod hvcs.ko hvcs_parm_num_devs=4”…””}”hjð  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´Kohj3  h²hubhÌ)”}”(hŒøThere is a maximum number of dev entries that can be specified on insmod.
We think that 1024 is currently a decent maximum number of server adapters
to allow.  This can always be changed by modifying the constant in the
source file before building.”h]”hŒøThere is a maximum number of dev entries that can be specified on insmod.
We think that 1024 is currently a decent maximum number of server adapters
to allow.  This can always be changed by modifying the constant in the
source file before building.”…””}”(hjþ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kqhj3  h²hubhÌ)”}”(hŒ‹NOTE: The length of time it takes to insmod the driver seems to be related
to the number of tty interfaces the registering driver requests.”h]”hŒ‹NOTE: The length of time it takes to insmod the driver seems to be related
to the number of tty interfaces the registering driver requests.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kvhj3  h²hubhÌ)”}”(hŒDIn order to remove the driver module execute the following command::”h]”hŒCIn order to remove the driver module execute the following command:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kyhj3  h²hubj  )”}”(hŒrmmod hvcs.ko”h]”hŒrmmod hvcs.ko”…””}”hj(  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´K{hj3  h²hubhÌ)”}”(hŒ™The recommended method for installing hvcs as a module is to use depmod to
build a current modules.dep file in /lib/modules/`uname -r` and then
execute::”h]”(hŒ|The recommended method for installing hvcs as a module is to use depmod to
build a current modules.dep file in /lib/modules/”…””}”(hj6  h²hh³Nh´NubhŒtitle_reference”“”)”}”(hŒ
`uname -r`”h]”hŒuname -r”…””}”(hj@  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j>  hj6  ubhŒ and then
execute:”…””}”(hj6  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K}hj3  h²hubj  )”}”(hŒ"modprobe hvcs hvcs_parm_num_devs=4”h]”hŒ"modprobe hvcs hvcs_parm_num_devs=4”…””}”hjX  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´Khj3  h²hubhÌ)”}”(hŒ£The modules.dep file indicates that hvcserver.ko needs to be inserted
before hvcs.ko and modprobe uses this file to smartly insert the modules in
the proper order.”h]”hŒ£The modules.dep file indicates that hvcserver.ko needs to be inserted
before hvcs.ko and modprobe uses this file to smartly insert the modules in
the proper order.”…””}”(hjf  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kƒhj3  h²hubhÌ)”}”(hŒYThe following modprobe command is used to remove hvcs and hvcserver in the
proper order::”h]”hŒXThe following modprobe command is used to remove hvcs and hvcserver in the
proper order:”…””}”(hjt  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K‡hj3  h²hubj  )”}”(hŒmodprobe -r hvcs”h]”hŒmodprobe -r hvcs”…””}”hj‚  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´KŠhj3  h²hubeh}”(h]”Œmodule”ah ]”h"]”Œ3.2 module:”ah$]”h&]”uh1hµhjÁ  h²hh³hÊh´KTubeh}”(h]”Œbuild-options”ah ]”h"]”Œ3. build options:”ah$]”h&]”uh1hµhh·h²hh³hÊh´K;ubh¶)”}”(hhh]”(h»)”}”(hŒ4. Installation:”h]”hŒ4. Installation:”…””}”(hj£  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj   h²hh³hÊh´KubhÌ)”}”(hŒÕThe tty layer creates sysfs entries which contain the major and minor
numbers allocated for the hvcs driver.  The following snippet of "tree"
output of the sysfs directory shows where these numbers are presented::”h]”hŒØThe tty layer creates sysfs entries which contain the major and minor
numbers allocated for the hvcs driver.  The following snippet of â€œtreeâ€
output of the sysfs directory shows where these numbers are presented:”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj   h²hubj  )”}”(hXk  sys/
|-- *other sysfs base dirs*
|
|-- class
|   |-- *other classes of devices*
|   |
|   `-- tty
|       |-- *other tty devices*
|       |
|       |-- hvcs0
|       |   `-- dev
|       |-- hvcs1
|       |   `-- dev
|       |-- hvcs2
|       |   `-- dev
|       |-- hvcs3
|       |   `-- dev
|       |
|       |-- *other tty devices*
|
|-- *other sysfs base dirs*”h]”hXk  sys/
|-- *other sysfs base dirs*
|
|-- class
|   |-- *other classes of devices*
|   |
|   `-- tty
|       |-- *other tty devices*
|       |
|       |-- hvcs0
|       |   `-- dev
|       |-- hvcs1
|       |   `-- dev
|       |-- hvcs2
|       |   `-- dev
|       |-- hvcs3
|       |   `-- dev
|       |
|       |-- *other tty devices*
|
|-- *other sysfs base dirs*”…””}”hj¿  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´K“hj   h²hubhÌ)”}”(hŒjFor the above examples the following output is a result of cat'ing the
"dev" entry in the hvcs directory::”h]”hŒoFor the above examples the following output is a result of catâ€™ing the
â€œdevâ€ entry in the hvcs directory:”…””}”(hjÍ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K©hj   h²hubj  )”}”(hŒ®Pow5:/sys/class/tty/hvcs0/ # cat dev
254:0

Pow5:/sys/class/tty/hvcs1/ # cat dev
254:1

Pow5:/sys/class/tty/hvcs2/ # cat dev
254:2

Pow5:/sys/class/tty/hvcs3/ # cat dev
254:3”h]”hŒ®Pow5:/sys/class/tty/hvcs0/ # cat dev
254:0

Pow5:/sys/class/tty/hvcs1/ # cat dev
254:1

Pow5:/sys/class/tty/hvcs2/ # cat dev
254:2

Pow5:/sys/class/tty/hvcs3/ # cat dev
254:3”…””}”hjÛ  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´K¬hj   h²hubhÌ)”}”(hŒøThe output from reading the "dev" attribute is the char device major and
minor numbers that the tty layer has allocated for this driver's use.  Most
systems running hvcs will already have the device entries created or udev
will do it automatically.”h]”hŒþThe output from reading the â€œdevâ€ attribute is the char device major and
minor numbers that the tty layer has allocated for this driverâ€™s use.  Most
systems running hvcs will already have the device entries created or udev
will do it automatically.”…””}”(hjé  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¸hj   h²hubhÌ)”}”(hŒiGiven the example output above, to manually create a /dev/hvcs* node entry
mknod can be used as follows::”h]”hŒhGiven the example output above, to manually create a /dev/hvcs* node entry
mknod can be used as follows:”…””}”(hj÷  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K½hj   h²hubj  )”}”(hŒcmknod /dev/hvcs0 c 254 0
mknod /dev/hvcs1 c 254 1
mknod /dev/hvcs2 c 254 2
mknod /dev/hvcs3 c 254 3”h]”hŒcmknod /dev/hvcs0 c 254 0
mknod /dev/hvcs1 c 254 1
mknod /dev/hvcs2 c 254 2
mknod /dev/hvcs3 c 254 3”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´KÀhj   h²hubhÌ)”}”(hŒUsing mknod to manually create the device entries makes these device nodes
persistent.  Once created they will exist prior to the driver insmod.”h]”hŒUsing mknod to manually create the device entries makes these device nodes
persistent.  Once created they will exist prior to the driver insmod.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÅhj   h²hubhÌ)”}”(hŒ“Attempting to connect an application to /dev/hvcs* prior to insertion of
the hvcs module will result in an error message similar to the following::”h]”hŒ’Attempting to connect an application to /dev/hvcs* prior to insertion of
the hvcs module will result in an error message similar to the following:”…””}”(hj!  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÈhj   h²hubj  )”}”(hŒ"/dev/hvcs*: No such device".”h]”hŒ"/dev/hvcs*: No such device".”…””}”hj/  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´KËhj   h²hubhÌ)”}”(hŒzNOTE: Just because there is a device node present doesn't mean that there
is a vty-server device configured for that node.”h]”hŒ|NOTE: Just because there is a device node present doesnâ€™t mean that there
is a vty-server device configured for that node.”…””}”(hj=  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÍhj   h²hubeh}”(h]”Œinstallation”ah ]”h"]”Œ4. installation:”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ5. Connection”h]”hŒ5. Connection”…””}”(hjV  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjS  h²hh³hÊh´KÑubhÌ)”}”(hX  Since this driver controls devices that provide a tty interface a user can
interact with the device node entries using any standard tty-interactive
method (e.g. "cat", "dd", "echo").  The intent of this driver however, is
to provide real time console interaction with a Linux partition's console,
which requires the use of applications that provide bi-directional,
interactive I/O with a tty device.”h]”hX  Since this driver controls devices that provide a tty interface a user can
interact with the device node entries using any standard tty-interactive
method (e.g. â€œcatâ€, â€œddâ€, â€œechoâ€).  The intent of this driver however, is
to provide real time console interaction with a Linux partitionâ€™s console,
which requires the use of applications that provide bi-directional,
interactive I/O with a tty device.”…””}”(hjd  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÓhjS  h²hubhÌ)”}”(hX`  Applications (e.g. "minicom" and "screen") that act as terminal emulators
or perform terminal type control sequence conversion on the data being
passed through them are NOT acceptable for providing interactive console
I/O.  These programs often emulate antiquated terminal types (vt100 and
ANSI) and expect inbound data to take the form of one of these supported
terminal types but they either do not convert, or do not _adequately_
convert, outbound data into the terminal type of the terminal which invoked
them (though screen makes an attempt and can apparently be configured with
much termcap wrestling.)”h]”hXh  Applications (e.g. â€œminicomâ€ and â€œscreenâ€) that act as terminal emulators
or perform terminal type control sequence conversion on the data being
passed through them are NOT acceptable for providing interactive console
I/O.  These programs often emulate antiquated terminal types (vt100 and
ANSI) and expect inbound data to take the form of one of these supported
terminal types but they either do not convert, or do not _adequately_
convert, outbound data into the terminal type of the terminal which invoked
them (though screen makes an attempt and can apparently be configured with
much termcap wrestling.)”…””}”(hjr  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÚhjS  h²hubhÌ)”}”(hXd  For this reason kermit and cu are two of the recommended applications for
interacting with a Linux console via an hvcs device.  These programs simply
act as a conduit for data transfer to and from the tty device.  They do not
require inbound data to take the form of a particular terminal type, nor do
they cook outbound data to a particular terminal type.”h]”hXd  For this reason kermit and cu are two of the recommended applications for
interacting with a Linux console via an hvcs device.  These programs simply
act as a conduit for data transfer to and from the tty device.  They do not
require inbound data to take the form of a particular terminal type, nor do
they cook outbound data to a particular terminal type.”…””}”(hj€  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KähjS  h²hubhÌ)”}”(hX(  In order to ensure proper functioning of console applications one must make
sure that once connected to a /dev/hvcs console that the console's $TERM
env variable is set to the exact terminal type of the terminal emulator
used to launch the interactive I/O application.  If one is using xterm and
kermit to connect to /dev/hvcs0 when the console prompt becomes available
one should "export TERM=xterm" on the console.  This tells ncurses
applications that are invoked from the console that they should output
control sequences that xterm can understand.”h]”hX.  In order to ensure proper functioning of console applications one must make
sure that once connected to a /dev/hvcs console that the consoleâ€™s $TERM
env variable is set to the exact terminal type of the terminal emulator
used to launch the interactive I/O application.  If one is using xterm and
kermit to connect to /dev/hvcs0 when the console prompt becomes available
one should â€œexport TERM=xtermâ€ on the console.  This tells ncurses
applications that are invoked from the console that they should output
control sequences that xterm can understand.”…””}”(hjŽ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KêhjS  h²hubhÌ)”}”(hXY  As a precautionary measure an hvcs user should always "exit" from their
session before disconnecting an application such as kermit from the device
node.  If this is not done, the next user to connect to the console will
continue using the previous user's logged in session which includes
using the $TERM variable that the previous user supplied.”h]”hX_  As a precautionary measure an hvcs user should always â€œexitâ€ from their
session before disconnecting an application such as kermit from the device
node.  If this is not done, the next user to connect to the console will
continue using the previous userâ€™s logged in session which includes
using the $TERM variable that the previous user supplied.”…””}”(hjœ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KóhjS  h²hubhÌ)”}”(hX   Hotplug add and remove of vty-server adapters affects which /dev/hvcs* node
is used to connect to each vty-server adapter.  In order to determine which
vty-server adapter is associated with which /dev/hvcs* node a special sysfs
attribute has been added to each vty-server sysfs entry.  This entry is
called "index" and showing it reveals an integer that refers to the
/dev/hvcs* entry to use to connect to that device.  For instance cating the
index attribute of vty-server adapter 30000004 shows the following::”h]”hX  Hotplug add and remove of vty-server adapters affects which /dev/hvcs* node
is used to connect to each vty-server adapter.  In order to determine which
vty-server adapter is associated with which /dev/hvcs* node a special sysfs
attribute has been added to each vty-server sysfs entry.  This entry is
called â€œindexâ€ and showing it reveals an integer that refers to the
/dev/hvcs* entry to use to connect to that device.  For instance cating the
index attribute of vty-server adapter 30000004 shows the following:”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KùhjS  h²hubj  )”}”(hŒ5Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat index
2”h]”hŒ5Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat index
2”…””}”hj¸  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´MhjS  h²hubhÌ)”}”(hŒyThis index of '2' means that in order to connect to vty-server adapter
30000004 the user should interact with /dev/hvcs2.”h]”hŒ}This index of â€˜2â€™ means that in order to connect to vty-server adapter
30000004 the user should interact with /dev/hvcs2.”…””}”(hjÆ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjS  h²hubhÌ)”}”(hX  It should be noted that due to the system hotplug I/O capabilities of a
system the /dev/hvcs* entry that interacts with a particular vty-server
adapter is not guaranteed to remain the same across system reboots.  Look
in the Q & A section for more on this issue.”h]”hX  It should be noted that due to the system hotplug I/O capabilities of a
system the /dev/hvcs* entry that interacts with a particular vty-server
adapter is not guaranteed to remain the same across system reboots.  Look
in the Q & A section for more on this issue.”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjS  h²hubeh}”(h]”Œ
connection”ah ]”h"]”Œ5. connection”ah$]”h&]”uh1hµhh·h²hh³hÊh´KÑubh¶)”}”(hhh]”(h»)”}”(hŒ6. Disconnection”h]”hŒ6. Disconnection”…””}”(hjí  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjê  h²hh³hÊh´MubhÌ)”}”(hX  As a security feature to prevent the delivery of stale data to an
unintended target the Power5 system firmware disables the fetching of data
and discards that data when a connection between a vty-server and a vty has
been severed.  As an example, when a vty-server is immediately disconnected
from a vty following output of data to the vty the vty adapter may not have
enough time between when it received the data interrupt and when the
connection was severed to fetch the data from firmware before the fetch is
disabled by firmware.”h]”hX  As a security feature to prevent the delivery of stale data to an
unintended target the Power5 system firmware disables the fetching of data
and discards that data when a connection between a vty-server and a vty has
been severed.  As an example, when a vty-server is immediately disconnected
from a vty following output of data to the vty the vty adapter may not have
enough time between when it received the data interrupt and when the
connection was severed to fetch the data from firmware before the fetch is
disabled by firmware.”…””}”(hjû  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjê  h²hubhÌ)”}”(hX`  When hvcs is being used to serve consoles this behavior is not a huge issue
because the adapter stays connected for large amounts of time following
almost all data writes.  When hvcs is being used as a tty conduit to tunnel
data between two partitions [see Q & A below] this is a huge problem
because the standard Linux behavior when cat'ing or dd'ing data to a device
is to open the tty, send the data, and then close the tty.  If this driver
manually terminated vty-server connections on tty close this would close
the vty-server and vty connection before the target vty has had a chance to
fetch the data.”h]”hXd  When hvcs is being used to serve consoles this behavior is not a huge issue
because the adapter stays connected for large amounts of time following
almost all data writes.  When hvcs is being used as a tty conduit to tunnel
data between two partitions [see Q & A below] this is a huge problem
because the standard Linux behavior when catâ€™ing or ddâ€™ing data to a device
is to open the tty, send the data, and then close the tty.  If this driver
manually terminated vty-server connections on tty close this would close
the vty-server and vty connection before the target vty has had a chance to
fetch the data.”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjê  h²hubhÌ)”}”(hŒÌAdditionally, disconnecting a vty-server and vty only on module removal or
adapter removal is impractical because other vty-servers in other
partitions may require the usage of the target vty at any time.”h]”hŒÌAdditionally, disconnecting a vty-server and vty only on module removal or
adapter removal is impractical because other vty-servers in other
partitions may require the usage of the target vty at any time.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M"hjê  h²hubhÌ)”}”(hX:  Due to this behavioral restriction disconnection of vty-servers from the
connected vty is a manual procedure using a write to a sysfs attribute
outlined below, on the other hand the initial vty-server connection to a
vty is established automatically by this driver.  Manual vty-server
connection is never required.”h]”hX:  Due to this behavioral restriction disconnection of vty-servers from the
connected vty is a manual procedure using a write to a sysfs attribute
outlined below, on the other hand the initial vty-server connection to a
vty is established automatically by this driver.  Manual vty-server
connection is never required.”…””}”(hj%  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M&hjê  h²hubhÌ)”}”(hXS  In order to terminate the connection between a vty-server and vty the
"vterm_state" sysfs attribute within each vty-server's sysfs entry is used.
Reading this attribute reveals the current connection state of the
vty-server adapter.  A zero means that the vty-server is not connected to a
vty.  A one indicates that a connection is active.”h]”hXY  In order to terminate the connection between a vty-server and vty the
â€œvterm_stateâ€ sysfs attribute within each vty-serverâ€™s sysfs entry is used.
Reading this attribute reveals the current connection state of the
vty-server adapter.  A zero means that the vty-server is not connected to a
vty.  A one indicates that a connection is active.”…””}”(hj3  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M,hjê  h²hubhÌ)”}”(hXº  Writing a '0' (zero) to the vterm_state attribute will disconnect the VTERM
connection between the vty-server and target vty ONLY if the vterm_state
previously read '1'.  The write directive is ignored if the vterm_state
read '0' or if any value other than '0' was written to the vterm_state
attribute.  The following example will show the method used for verifying
the vty-server connection status and disconnecting a vty-server connection::”h]”hXÉ  Writing a â€˜0â€™ (zero) to the vterm_state attribute will disconnect the VTERM
connection between the vty-server and target vty ONLY if the vterm_state
previously read â€˜1â€™.  The write directive is ignored if the vterm_state
read â€˜0â€™ or if any value other than â€˜0â€™ was written to the vterm_state
attribute.  The following example will show the method used for verifying
the vty-server connection status and disconnecting a vty-server connection:”…””}”(hjA  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M2hjê  h²hubj  )”}”(hŒ¸Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat vterm_state
1

Pow5:/sys/bus/vio/drivers/hvcs/30000004 # echo 0 > vterm_state

Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat vterm_state
0”h]”hŒ¸Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat vterm_state
1

Pow5:/sys/bus/vio/drivers/hvcs/30000004 # echo 0 > vterm_state

Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat vterm_state
0”…””}”hjO  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´M9hjê  h²hubhÌ)”}”(hŒzAll vty-server connections are automatically terminated when the device is
hotplug removed and when the module is removed.”h]”hŒzAll vty-server connections are automatically terminated when the device is
hotplug removed and when the module is removed.”…””}”(hj]  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MAhjê  h²hubeh}”(h]”Œdisconnection”ah ]”h"]”Œ6. disconnection”ah$]”h&]”uh1hµhh·h²hh³hÊh´Mubh¶)”}”(hhh]”(h»)”}”(hŒ7. Configuration”h]”hŒ7. Configuration”…””}”(hjv  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjs  h²hh³hÊh´MEubhÌ)”}”(hŒÎEach vty-server has a sysfs entry in the /sys/devices/vio directory, which
is symlinked in several other sysfs tree directories, notably under the
hvcs driver entry, which looks like the following example::”h]”hŒÍEach vty-server has a sysfs entry in the /sys/devices/vio directory, which
is symlinked in several other sysfs tree directories, notably under the
hvcs driver entry, which looks like the following example:”…””}”(hj„  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MGhjs  h²hubj  )”}”(hŒEPow5:/sys/bus/vio/drivers/hvcs # ls
.  ..  30000003  30000004  rescan”h]”hŒEPow5:/sys/bus/vio/drivers/hvcs # ls
.  ..  30000003  30000004  rescan”…””}”hj’  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´MKhjs  h²hubhÌ)”}”(hXÍ  By design, firmware notifies the hvcs driver of vty-server lifetimes and
partner vty removals but not the addition of partner vtys.  Since an HMC
Super Admin can add partner info dynamically we have provided the hvcs
driver sysfs directory with the "rescan" update attribute which will query
firmware and update the partner info for all the vty-servers that this
driver manages.  Writing a '1' to the attribute triggers the update.  An
explicit example follows:”h]”hXÕ  By design, firmware notifies the hvcs driver of vty-server lifetimes and
partner vty removals but not the addition of partner vtys.  Since an HMC
Super Admin can add partner info dynamically we have provided the hvcs
driver sysfs directory with the â€œrescanâ€ update attribute which will query
firmware and update the partner info for all the vty-servers that this
driver manages.  Writing a â€˜1â€™ to the attribute triggers the update.  An
explicit example follows:”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MNhjs  h²hubjo  )”}”(hŒ1Pow5:/sys/bus/vio/drivers/hvcs # echo 1 > rescan
”h]”hÌ)”}”(hŒ0Pow5:/sys/bus/vio/drivers/hvcs # echo 1 > rescan”h]”hŒ0Pow5:/sys/bus/vio/drivers/hvcs # echo 1 > rescan”…””}”(hj²  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MVhj®  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jn  h³hÊh´MVhjs  h²hubhÌ)”}”(hŒ¯Reading the attribute will indicate a state of '1' or '0'.  A one indicates
that an update is in process.  A zero indicates that an update has
completed or was never executed.”h]”hŒ·Reading the attribute will indicate a state of â€˜1â€™ or â€˜0â€™.  A one indicates
that an update is in process.  A zero indicates that an update has
completed or was never executed.”…””}”(hjÆ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MXhjs  h²hubhÌ)”}”(hŒªVty-server entries in this directory are a 32 bit partition unique unit
address that is created by firmware.  An example vty-server sysfs entry
looks like the following::”h]”hŒ©Vty-server entries in this directory are a 32 bit partition unique unit
address that is created by firmware.  An example vty-server sysfs entry
looks like the following:”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M\hjs  h²hubj  )”}”(hŒ“Pow5:/sys/bus/vio/drivers/hvcs/30000004 # ls
.   current_vty   devspec       name          partner_vtys
..  index         partner_clcs  vterm_state”h]”hŒ“Pow5:/sys/bus/vio/drivers/hvcs/30000004 # ls
.   current_vty   devspec       name          partner_vtys
..  index         partner_clcs  vterm_state”…””}”hjâ  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´M`hjs  h²hubhÌ)”}”(hŒ™Each entry is provided, by default with a "name" attribute.  Reading the
"name" attribute will reveal the device type as shown in the following
example::”h]”hŒ Each entry is provided, by default with a â€œnameâ€ attribute.  Reading the
â€œnameâ€ attribute will reveal the device type as shown in the following
example:”…””}”(hjð  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mdhjs  h²hubj  )”}”(hŒ=Pow5:/sys/bus/vio/drivers/hvcs/30000003 # cat name
vty-server”h]”hŒ=Pow5:/sys/bus/vio/drivers/hvcs/30000003 # cat name
vty-server”…””}”hjþ  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´Mhhjs  h²hubhÌ)”}”(hŒžEach entry is also provided, by default, with a "devspec" attribute which
reveals the full device specification when read, as shown in the following
example::”h]”hŒ¡Each entry is also provided, by default, with a â€œdevspecâ€ attribute which
reveals the full device specification when read, as shown in the following
example:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mkhjs  h²hubj  )”}”(hŒRPow5:/sys/bus/vio/drivers/hvcs/30000004 # cat devspec
/vdevice/vty-server@30000004”h]”hŒRPow5:/sys/bus/vio/drivers/hvcs/30000004 # cat devspec
/vdevice/vty-server@30000004”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´Mohjs  h²hubhÌ)”}”(hŒEach vty-server sysfs dir is provided with two read-only attributes that
provide lists of easily parsed partner vty data: "partner_vtys" and
"partner_clcs"::”h]”hŒ¤Each vty-server sysfs dir is provided with two read-only attributes that
provide lists of easily parsed partner vty data: â€œpartner_vtysâ€ and
â€œpartner_clcsâ€:”…””}”(hj(  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mrhjs  h²hubj  )”}”(hX  Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat partner_vtys
30000000
30000001
30000002
30000000
30000000

Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat partner_clcs
U5112.428.103048A-V3-C0
U5112.428.103048A-V3-C2
U5112.428.103048A-V3-C3
U5112.428.103048A-V4-C0
U5112.428.103048A-V5-C0”h]”hX  Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat partner_vtys
30000000
30000001
30000002
30000000
30000000

Pow5:/sys/bus/vio/drivers/hvcs/30000004 # cat partner_clcs
U5112.428.103048A-V3-C0
U5112.428.103048A-V3-C2
U5112.428.103048A-V3-C3
U5112.428.103048A-V4-C0
U5112.428.103048A-V5-C0”…””}”hj6  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´Mvhjs  h²hubhÌ)”}”(hŒReading partner_vtys returns a list of partner vtys.  Vty unit address
numbering is only per-partition-unique so entries will frequently repeat.”h]”hŒReading partner_vtys returns a list of partner vtys.  Vty unit address
numbering is only per-partition-unique so entries will frequently repeat.”…””}”(hjD  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M„hjs  h²hubhÌ)”}”(hXR  Reading partner_clcs returns a list of "converged location codes" which are
composed of a system serial number followed by "-V*", where the '*' is the
target partition number, and "-C*", where the '*' is the slot of the
adapter.  The first vty partner corresponds to the first clc item, the
second vty partner to the second clc item, etc.”h]”hXf  Reading partner_clcs returns a list of â€œconverged location codesâ€ which are
composed of a system serial number followed by â€œ-V*â€, where the â€˜*â€™ is the
target partition number, and â€œ-C*â€, where the â€˜*â€™ is the slot of the
adapter.  The first vty partner corresponds to the first clc item, the
second vty partner to the second clc item, etc.”…””}”(hjR  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M‡hjs  h²hubhÌ)”}”(hŒ—A vty-server can only be connected to a single vty at a time.  The entry,
"current_vty" prints the clc of the currently selected partner vty when
read.”h]”hŒ›A vty-server can only be connected to a single vty at a time.  The entry,
â€œcurrent_vtyâ€ prints the clc of the currently selected partner vty when
read.”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjs  h²hubhÌ)”}”(hŒhThe current_vty can be changed by writing a valid partner clc to the entry
as in the following example::”h]”hŒgThe current_vty can be changed by writing a valid partner clc to the entry
as in the following example:”…””}”(hjn  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M‘hjs  h²hubj  )”}”(hŒUPow5:/sys/bus/vio/drivers/hvcs/30000004 # echo U5112.428.10304
8A-V4-C0 > current_vty”h]”hŒUPow5:/sys/bus/vio/drivers/hvcs/30000004 # echo U5112.428.10304
8A-V4-C0 > current_vty”…””}”hj|  sbah}”(h]”h ]”h"]”h$]”h&]”hùhúuh1j  h³hÊh´M”hjs  h²hubhÌ)”}”(hŒ¶Changing the current_vty when a vty-server is already connected to a vty
does not affect the current connection.  The change takes effect when the
currently open connection is freed.”h]”hŒ¶Changing the current_vty when a vty-server is already connected to a vty
does not affect the current connection.  The change takes effect when the
currently open connection is freed.”…””}”(hjŠ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M—hjs  h²hubhÌ)”}”(hŒgInformation on the "vterm_state" attribute was covered earlier on the
chapter entitled "disconnection".”h]”hŒoInformation on the â€œvterm_stateâ€ attribute was covered earlier on the
chapter entitled â€œdisconnectionâ€.”…””}”(hj˜  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M›hjs  h²hubeh}”(h]”Œconfiguration”ah ]”h"]”Œ7. configuration”ah$]”h&]”uh1hµhh·h²hh³hÊh´MEubh¶)”}”(hhh]”(h»)”}”(hŒ8. Questions & Answers:”h]”hŒ8. Questions & Answers:”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj®  h²hh³hÊh´MŸubhÌ)”}”(hŒ1Q: What are the security concerns involving hvcs?”h]”hŒ1Q: What are the security concerns involving hvcs?”…””}”(hj¿  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M¡hj®  h²hubhÌ)”}”(hŒ*A: There are three main security concerns:”h]”hŒ*A: There are three main security concerns:”…””}”(hjÍ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M£hj®  h²hubjo  )”}”(hX^  1. The creator of the /dev/hvcs* nodes has the ability to restrict
the access of the device entries to certain users or groups.  It
may be best to create a special hvcs group privilege for providing
access to system consoles.

2. To provide network security when grabbing the console it is
suggested that the user connect to the console hosting partition
using a secure method, such as SSH or sit at a hardware console.

3. Make sure to exit the user session when done with a console or
the next vty-server connection (which may be from another
partition) will experience the previously logged in session.
”h]”(hÌ)”}”(hŒá1. The creator of the /dev/hvcs* nodes has the ability to restrict
the access of the device entries to certain users or groups.  It
may be best to create a special hvcs group privilege for providing
access to system consoles.”h]”hŒá1. The creator of the /dev/hvcs* nodes has the ability to restrict
the access of the device entries to certain users or groups.  It
may be best to create a special hvcs group privilege for providing
access to system consoles.”…””}”(hjß  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M¥hjÛ  ubhÌ)”}”(hŒÀ2. To provide network security when grabbing the console it is
suggested that the user connect to the console hosting partition
using a secure method, such as SSH or sit at a hardware console.”h]”hŒÀ2. To provide network security when grabbing the console it is
suggested that the user connect to the console hosting partition
using a secure method, such as SSH or sit at a hardware console.”…””}”(hjí  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MªhjÛ  ubhÌ)”}”(hŒ¸3. Make sure to exit the user session when done with a console or
the next vty-server connection (which may be from another
partition) will experience the previously logged in session.”h]”hŒ¸3. Make sure to exit the user session when done with a console or
the next vty-server connection (which may be from another
partition) will experience the previously logged in session.”…””}”(hjû  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M®hjÛ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jn  h³hÊh´M¥hj®  h²hubhŒ
transition”“”)”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M²hj®  h²hubhÌ)”}”(hŒYQ: How do I multiplex a console that I grab through hvcs so that other
people can see it:”h]”hŒYQ: How do I multiplex a console that I grab through hvcs so that other
people can see it:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M´hj®  h²hubhÌ)”}”(hX–  A: You can use "screen" to directly connect to the /dev/hvcs* device and
setup a session on your machine with the console group privileges.  As
pointed out earlier by default screen doesn't provide the termcap settings
for most terminal emulators to provide adequate character conversion from
term type "screen" to others.  This means that curses based programs may
not display properly in screen sessions.”h]”hX   A: You can use â€œscreenâ€ to directly connect to the /dev/hvcs* device and
setup a session on your machine with the console group privileges.  As
pointed out earlier by default screen doesnâ€™t provide the termcap settings
for most terminal emulators to provide adequate character conversion from
term type â€œscreenâ€ to others.  This means that curses based programs may
not display properly in screen sessions.”…””}”(hj)  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M·hj®  h²hubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M¾hj®  h²hubhÌ)”}”(hŒ¢Q: Why are the colors all messed up?
Q: Why are the control characters acting strange or not working?
Q: Why is the console output all strange and unintelligible?”h]”hŒ¢Q: Why are the colors all messed up?
Q: Why are the control characters acting strange or not working?
Q: Why is the console output all strange and unintelligible?”…””}”(hjA  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÀhj®  h²hubhÌ)”}”(hXo  A: Please see the preceding section on "Connection" for a discussion of how
applications can affect the display of character control sequences.
Additionally, just because you logged into the console using and xterm
doesn't mean someone else didn't log into the console with the HMC console
(vt320) before you and leave the session logged in.  The best thing to do
is to export TERM to the terminal type of your terminal emulator when you
get the console.  Additionally make sure to "exit" the console before you
disconnect from the console.  This will ensure that the next user gets
their own TERM type set when they login.”h]”hX{  A: Please see the preceding section on â€œConnectionâ€ for a discussion of how
applications can affect the display of character control sequences.
Additionally, just because you logged into the console using and xterm
doesnâ€™t mean someone else didnâ€™t log into the console with the HMC console
(vt320) before you and leave the session logged in.  The best thing to do
is to export TERM to the terminal type of your terminal emulator when you
get the console.  Additionally make sure to â€œexitâ€ the console before you
disconnect from the console.  This will ensure that the next user gets
their own TERM type set when they login.”…””}”(hjO  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÄhj®  h²hubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´MÎhj®  h²hubhÌ)”}”(hŒuQ: When I try to CONNECT kermit to an hvcs device I get:
"Sorry, can't open connection: /dev/hvcs*"What is happening?”h]”hŒ{Q: When I try to CONNECT kermit to an hvcs device I get:
â€œSorry, canâ€™t open connection: /dev/hvcs*â€What is happening?”…””}”(hjg  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÐhj®  h²hubhÌ)”}”(hX  A: Some other Power5 console mechanism has a connection to the vty and
isn't giving it up.  You can try to force disconnect the consoles from the
HMC by right clicking on the partition and then selecting "close terminal".
Otherwise you have to hunt down the people who have console authority.  It
is possible that you already have the console open using another kermit
session and just forgot about it.  Please review the console options for
Power5 systems to determine the many ways a system console can be held.”h]”hX  A: Some other Power5 console mechanism has a connection to the vty and
isnâ€™t giving it up.  You can try to force disconnect the consoles from the
HMC by right clicking on the partition and then selecting â€œclose terminalâ€.
Otherwise you have to hunt down the people who have console authority.  It
is possible that you already have the console open using another kermit
session and just forgot about it.  Please review the console options for
Power5 systems to determine the many ways a system console can be held.”…””}”(hju  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÓhj®  h²hubhÌ)”}”(hŒOR”h]”hŒOR”…””}”(hjƒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÛhj®  h²hubhÌ)”}”(hX<  A: Another user may not have a connectivity method currently attached to a
/dev/hvcs device but the vterm_state may reveal that they still have the
vty-server connection established.  They need to free this using the method
outlined in the section on "Disconnection" in order for others to connect
to the target vty.”h]”hX@  A: Another user may not have a connectivity method currently attached to a
/dev/hvcs device but the vterm_state may reveal that they still have the
vty-server connection established.  They need to free this using the method
outlined in the section on â€œDisconnectionâ€ in order for others to connect
to the target vty.”…””}”(hj‘  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÝhj®  h²hubhÌ)”}”(hŒOR”h]”hŒOR”…””}”(hjŸ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mãhj®  h²hubhÌ)”}”(hŒsA: The user profile you are using to execute kermit probably doesn't have
permissions to use the /dev/hvcs* device.”h]”hŒuA: The user profile you are using to execute kermit probably doesnâ€™t have
permissions to use the /dev/hvcs* device.”…””}”(hj­  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Måhj®  h²hubhÌ)”}”(hŒOR”h]”hŒOR”…””}”(hj»  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mèhj®  h²hubhÌ)”}”(hŒxA: You probably haven't inserted the hvcs.ko module yet but the /dev/hvcs*
entry still exists (on systems without udev).”h]”hŒzA: You probably havenâ€™t inserted the hvcs.ko module yet but the /dev/hvcs*
entry still exists (on systems without udev).”…””}”(hjÉ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mêhj®  h²hubhÌ)”}”(hŒOR”h]”hŒOR”…””}”(hj×  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Míhj®  h²hubhÌ)”}”(hŒ\A: There is not a corresponding vty-server device that maps to an existing
/dev/hvcs* entry.”h]”hŒ\A: There is not a corresponding vty-server device that maps to an existing
/dev/hvcs* entry.”…””}”(hjå  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mïhj®  h²hubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Mòhj®  h²hubhÌ)”}”(hŒqQ: When I try to CONNECT kermit to an hvcs device I get:
"Sorry, write access to UUCP lockfile directory denied."”h]”hŒuQ: When I try to CONNECT kermit to an hvcs device I get:
â€œSorry, write access to UUCP lockfile directory denied.â€”…””}”(hjý  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Môhj®  h²hubhÌ)”}”(hŒA: The /dev/hvcs* entry you have specified doesn't exist where you said it
does?  Maybe you haven't inserted the module (on systems with udev).”h]”hŒ“A: The /dev/hvcs* entry you have specified doesnâ€™t exist where you said it
does?  Maybe you havenâ€™t inserted the module (on systems with udev).”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M÷hj®  h²hubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Múhj®  h²hubhÌ)”}”(hŒ—Q: If I already have one Linux partition installed can I use hvcs on said
partition to provide the console for the install of a second Linux
partition?”h]”hŒ—Q: If I already have one Linux partition installed can I use hvcs on said
partition to provide the console for the install of a second Linux
partition?”…””}”(hj#  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mühj®  h²hubhÌ)”}”(hŒ‘A: Yes granted that your are connected to the /dev/hvcs* device using
kermit or cu or some other program that doesn't provide terminal emulation.”h]”hŒ“A: Yes granted that your are connected to the /dev/hvcs* device using
kermit or cu or some other program that doesnâ€™t provide terminal emulation.”…””}”(hj1  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M hj®  h²hubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Mhj®  h²hubhÌ)”}”(hŒRQ: Can I connect to more than one partition's console at a time using this
driver?”h]”hŒTQ: Can I connect to more than one partitionâ€™s console at a time using this
driver?”…””}”(hjI  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj®  h²hubhÌ)”}”(hŒ’A: Yes.  Of course this means that there must be more than one vty-server
configured for this partition and each must point to a disconnected vty.”h]”hŒ’A: Yes.  Of course this means that there must be more than one vty-server
configured for this partition and each must point to a disconnected vty.”…””}”(hjW  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj®  h²hubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Mhj®  h²hubhÌ)”}”(hŒFQ: Does the hvcs driver support dynamic (hotplug) addition of devices?”h]”hŒFQ: Does the hvcs driver support dynamic (hotplug) addition of devices?”…””}”(hjo  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj®  h²hubhÌ)”}”(hŒÑA: Yes, if you have dlpar and hotplug enabled for your system and it has
been built into the kernel the hvcs drivers is configured to dynamically
handle additions of new devices and removals of unused devices.”h]”hŒÑA: Yes, if you have dlpar and hotplug enabled for your system and it has
been built into the kernel the hvcs drivers is configured to dynamically
handle additions of new devices and removals of unused devices.”…””}”(hj}  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj®  h²hubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Mhj®  h²hubhÌ)”}”(hŒhQ: For some reason /dev/hvcs* doesn't map to the same vty-server adapter
after a reboot.  What happened?”h]”hŒjQ: For some reason /dev/hvcs* doesnâ€™t map to the same vty-server adapter
after a reboot.  What happened?”…””}”(hj•  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj®  h²hubhÌ)”}”(hX  A: Assignment of vty-server adapters to /dev/hvcs* entries is always done
in the order that the adapters are exposed.  Due to hotplug capabilities of
this driver assignment of hotplug added vty-servers may be in a different
order than how they would be exposed on module load.  Rebooting or
reloading the module after dynamic addition may result in the /dev/hvcs*
and vty-server coupling changing if a vty-server adapter was added in a
slot between two other vty-server adapters.  Refer to the section above
on how to determine which vty-server goes with which /dev/hvcs* node.
Hint; look at the sysfs "index" attribute for the vty-server.”h]”hXƒ  A: Assignment of vty-server adapters to /dev/hvcs* entries is always done
in the order that the adapters are exposed.  Due to hotplug capabilities of
this driver assignment of hotplug added vty-servers may be in a different
order than how they would be exposed on module load.  Rebooting or
reloading the module after dynamic addition may result in the /dev/hvcs*
and vty-server coupling changing if a vty-server adapter was added in a
slot between two other vty-server adapters.  Refer to the section above
on how to determine which vty-server goes with which /dev/hvcs* node.
Hint; look at the sysfs â€œindexâ€ attribute for the vty-server.”…””}”(hj£  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj®  h²hubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M"hj®  h²hubhÌ)”}”(hŒ~Q: Can I use /dev/hvcs* as a conduit to another partition and use a tty
device on that partition as the other end of the pipe?”h]”hŒ~Q: Can I use /dev/hvcs* as a conduit to another partition and use a tty
device on that partition as the other end of the pipe?”…””}”(hj»  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M$hj®  h²hubhÌ)”}”(hX…  A: Yes, on Power5 platforms the hvc_console driver provides a tty interface
for extra /dev/hvc* devices (where /dev/hvc0 is most likely the console).
In order to get a tty conduit working between the two partitions the HMC
Super Admin must create an additional "serial server" for the target
partition with the HMC gui which will show up as /dev/hvc* when the target
partition is rebooted.”h]”hX‰  A: Yes, on Power5 platforms the hvc_console driver provides a tty interface
for extra /dev/hvc* devices (where /dev/hvc0 is most likely the console).
In order to get a tty conduit working between the two partitions the HMC
Super Admin must create an additional â€œserial serverâ€ for the target
partition with the HMC gui which will show up as /dev/hvc* when the target
partition is rebooted.”…””}”(hjÉ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M'hj®  h²hubhÌ)”}”(hŒðThe HMC Super Admin then creates an additional "serial client" for the
current partition and points this at the target partition's newly created
"serial server" adapter (remember the slot).  This shows up as an
additional /dev/hvcs* device.”h]”hŒúThe HMC Super Admin then creates an additional â€œserial clientâ€ for the
current partition and points this at the target partitionâ€™s newly created
â€œserial serverâ€ adapter (remember the slot).  This shows up as an
additional /dev/hvcs* device.”…””}”(hj×  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M.hj®  h²hubhÌ)”}”(hŒåNow a program on the target system can be configured to read or write to
/dev/hvc* and another program on the current partition can be configured to
read or write to /dev/hvcs*.  Now you have a tty conduit between two
partitions.”h]”hŒåNow a program on the target system can be configured to read or write to
/dev/hvc* and another program on the current partition can be configured to
read or write to /dev/hvcs*.  Now you have a tty conduit between two
partitions.”…””}”(hjå  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M3hj®  h²hubeh}”(h]”Œquestions-answers”ah ]”h"]”Œ8. questions & answers:”ah$]”h&]”uh1hµhh·h²hh³hÊh´MŸubj  )”}”(hŒK---------------------------------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M8hh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒ9. Reporting Bugs:”h]”hŒ9. Reporting Bugs:”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj	  h²hh³hÊh´M;ubhÌ)”}”(hŒ°The proper channel for reporting bugs is either through the Linux OS
distribution company that provided your OS or by posting issues to the
PowerPC development mailing list at:”h]”hŒ°The proper channel for reporting bugs is either through the Linux OS
distribution company that provided your OS or by posting issues to the
PowerPC development mailing list at:”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M=hj	  h²hubhÌ)”}”(hŒlinuxppc-dev@lists.ozlabs.org”h]”j   )”}”(hj&	  h]”hŒlinuxppc-dev@lists.ozlabs.org”…””}”(hj(	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ$mailto:linuxppc-dev@lists.ozlabs.org”uh1j  hj$	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MAhj	  h²hubhÌ)”}”(hŒšThis request is to provide a documented and searchable public exchange
of the problems and solutions surrounding this driver for the benefit of
all users.”h]”hŒšThis request is to provide a documented and searchable public exchange
of the problems and solutions surrounding this driver for the benefit of
all users.”…””}”(hj=	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MChj	  h²hubeh}”(h]”Œreporting-bugs”ah ]”h"]”Œ9. reporting bugs:”ah$]”h&]”uh1hµhh·h²hh³hÊh´M;ubeh}”(h]”Œ=hvcs-ibm-hypervisor-virtual-console-server-installation-guide”ah ]”h"]”Œ?hvcs ibm "hypervisor virtual console server" installation guide”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j~	  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jX	  jU	  j{  jx  j¾  j»  j  jš  j0  j-  j•  j’  jP  jM  jç  jä  jp  jm  j«  j¨  jø  jõ  jP	  jM	  uŒ	nametypes”}”(jX	  ‰j{  ‰j¾  ‰j  ‰j0  ‰j•  ‰jP  ‰jç  ‰jp  ‰j«  ‰jø  ‰jP	  ‰uh}”(jU	  h·jx  jW  j»  j~  jš  jÁ  j-  jî  j’  j3  jM  j   jä  jS  jm  jê  j¨  js  jõ  j®  jM	  j	  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.