Linux for Zseries: Device Drivers and Installation Commands (March 4, 2002) Summary of Changes
Total Page:16
File Type:pdf, Size:1020Kb
Linux for zSeries Device Drivers and Installation Commands (March 4, 2002) Linux Kernel 2.4 LNUX-1103-07 Linux for zSeries Device Drivers and Installation Commands (March 4, 2002) Linux Kernel 2.4 LNUX-1103-07 Note Before using this document, be sure to read the information in “Notices” on page 207. Eighth Edition – (March 2002) This edition applies to the Linux for zSeries kernel 2.4 patch (made in September 2001) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 2000, 2002. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Summary of changes .........v Chapter 5. Linux for zSeries Console || Edition 8 changes.............v device drivers............27 Edition 7 changes.............v Console features .............28 Edition 6 changes ............vi Console kernel parameter syntax .......28 Edition 5 changes ............vi Console kernel examples ..........28 Edition 4 changes ............vi Usingtheconsole............28 Edition 3 changes ............vii Console – Use of VInput ..........30 Edition 2 changes ............vii Console limitations ............31 About this book ...........ix Chapter 6. Channel attached tape How this book is organized .........ix device driver ............33 Who should read this book .........ix Tapedriverfeatures...........33 Assumptions..............ix Tape character device front-end........34 Tape block device front-end .........34 Part 1. Linux for zSeries Device Tape driver kernel parameter syntax ......35 drivers overview ..........1 Tapedriverkernelexample.........35 Tape driver module parameter syntax .....36 Tape driver module example ........36 Chapter 1. Common device support. 3 TapedevicedriverAPI..........37 Tapedriverexamples...........37 Chapter 2. Partitioning DASD .....5 Tape driver restrictions ..........38 Prerequisites ..............5 Tapedriverfurtherinformation........38 Why use partitions? ............5 Restrictions ...............5 Chapter 7. Generic cryptographic The partition table ............6 device driver ............39 zSeries disk layout (VTOC) .........6 Overview...............39 HMC settings..............40 Part 2. Linux for zSeries — zSeries Installing z90crypt ............41 device drivers ...........9 Decryptionusingz90crypt.........43 Otherfunctionsofz90crypt.........44 Chapter 3. Linux for zSeries DASD z90crypt header file ...........45 Crypto support for 31-bit emulation ......46 device driver ............11 Example of use: Apache ..........46 DASD overview .............11 DASD naming scheme using devfs ......11 DASD naming scheme without devfs ......12 Part 3. Linux for zSeries Network Partitioned DASD ............13 device drivers ...........49 DASD features .............14 DASD kernel parameter syntax ........15 Chapter 8. Linux for zSeries Channel DASD kernel example (using devfs) ......16 device layer ............51 DASD module parameter syntax .......17 Description ..............51 DASD module example ..........17 Channel device layer options ........52 DASD dynamic attach/detach ........17 Seealso................60 DASD – Preparingforuse.........18 Files .................61 DASD API (ioctl interface) .........19 DASD restrictions ............21 Chapter 9. Linux for zSeries Chapter 4. Linux for zSeries XPRAM CTC/ESCON device driver ......63 device driver ............23 CTC/ESCON features ...........63 CTC/ESCON with the channel device layer . 63 XPRAM features.............23 CTC/ESCON without the channel device layer . 64 Note on reusing XPRAM partitions ......23 CTC/ESCON – Preparing the connection ....66 XPRAM kernel parameter syntax .......24 CTC/ESCON – Recovery procedure after a crash . 69 XPRAM module parameter syntax.......25 © Copyright IBM Corp. 2000, 2002 iii Chapter 10. Linux for zSeries IUCV ifconfig - Configure a network interface ....144 device driver ............71 insmod - Load a module into the Linux kernel . 148 IUCVfeatures.............71 modprobe - Load a module with dependencies into IUCV kernel parameter syntax ........71 theLinuxkernel............150 IUCV kernel parameter example .......72 lsmod - List loaded modules ........153 IUCV module parameter syntax .......72 depmod - Create dependency descriptions for IUCV module parameter example .......72 loadable kernel modules..........154 IUCV – Preparing the connection .......73 mke2fs - Create a file system on DASD.....156 IUCV – Furtherinformation.........75 IUCV restrictions ............75 Chapter 14. VIPA – minimize outage IUCV Application Programming Interface (API) . 75 due to adapter failure ........157 Standard VIPA .............157 Chapter 11. Linux for zSeries LCS device driver ............93 Chapter 15. Kernel parameters ....159 LCS supported functions ..........93 ipldelay...............160 LCS channel device layer configuration .....93 maxcpus...............161 LCS channel device layer configuration example . 93 mem................162 || LCS kernel parameter syntax ........94 noinitrd...............163 LCSwarning..............95 ramdisk_size.............164 LCS restrictions .............95 ro.................165 root................166 Chapter 12. QETH device driver for vmhalt...............167 OSA-Express (QDIO) and HiperSockets. 97 cio_msg...............168 Naming conventions ...........97 Introduction ..............98 Chapter 16. Overview of the parameter Installing the modules ...........98 line file ..............169 QETH supported functions .........98 Parameters ..............170 Configuring QETH for OSA-Express and HiperSockets using the channel device layer . 99 Appendix A. Reference information 171 QETH parameter syntax..........101 LCS parameter syntax ..........171 OSA-Express feature in QDIO mode channel LCS module parameter syntax (without the devicelayerconfigurationexample......102 channel device layer) ...........171 HiperSockets channel device layer configuration OSA-Express and HiperSockets parameter syntax 172 example...............102 OSA-Express and HiperSockets driver command Examples: OSA-Express feature in QDIO mode . 103 syntax (without the channel device layer) ....172 Examples: HiperSockets ..........104 Linux for zSeries Major/Minor numbers ....173 OSA-Express feature in QDIO mode and HiperSockets – Preparing the connection ....105 Appendix B. Kernel building .....175 IP address takeover ...........106 Buildingthekernel...........175 OSA-Express feature in QDIO mode – Virtual IP Using ’config’ or ’oldconfig’ ........179 address (VIPA) .............107 Using ’menuconfig’ ...........184 QETH restrictions ............108 Kernel parameter options .........196 Priority queuing ............108 Glossary .............203 Part 4. Installation commands and parameters ............111 Notices ..............207 Trademarks..............208 Chapter 13. Useful Linux commands 113 dasdfmt - Format a DASD .........114 International License Agreement for dasdview - Display DASD Structure ......118 Non-Warranted Programs ......209 fdasd – DASD partitioning tool .......127 | snIPL – Remote control of Support Element (SE) Index ...............215 || functions...............134 zIPL – zSeries initial program loader .....138 iv Linux for zSeries: Device Drivers and Installation Commands (March 4, 2002) Summary of changes This revision contains changes to support the Linux for zSeries kernel loadable module for the Linux kernel version 2.4. | Edition 8 changes | New Information | v snIPL tool | v Setting up XPRAM dynamically | v Reference to Dump Tools manual | Changed Information | v Open-source LCS driver | v Corrected the separator (colon) between multiple guest-machine IDs in the iucv | kernel parameter and insmod command line. | v Added references to VIPA requirement for kernel built with CONFIG_DUMMY | kernel option. | This revision also includes maintenance and editorial changes. Technical changes | or additions to the text and illustrations are indicated by a vertical line to the left | of the change. | Deleted Information | v References to CONFIG_IP_ALIAS kernel option Edition 7 changes New Information v Option u added to fdasd. The option re-creates VTOC labels and keeps the partitions. v VIPA (virtual IP addressing) chapter v Installation instructions for qdio and qeth modules v z90crypt cryptographic device driver Changed Information This revision also includes maintenance and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change. Deleted Information v Parameter buffer_count (replaced by mem_in_k) in QETH © Copyright IBM Corp. 2000, 2002 v Edition 6 changes New Information v DASDview v Hipersockets Changed Information This revision also includes maintenance and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change. v OSA-Express – Clarifying editorial changes v fdasd – r and s options added v zIPL – Use of quotes Edition 5 changes New Information v VIPA v IP address takeover v Hipersockets Changed Information This revision also includes maintenance and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change. v OSA-Express – Updates for new cards v IUCV – New API v Kernel building restrictions. Edition 4 changes New Information v Channel device layer v Device file system v Tape driver v zIPL utility