#! /bin/sh # # qeth_configure # # Copyright (c) 2017 SUSE LINUX GmbH, Nuernberg, Germany. # # Configures a qeth device by calling the IBM-provided chzdev command. # Whereas this script used to validate the parameters provided to it, # we now rely on chzdev to do that instead. The script is intended only # as a "translation layer" to provide backward compatability for older # scripts and tools that invoke it. # # Usage: # qeth_configure [-i] [-l] [-f -t ] [-o "Values"] -n -p # # -i Configure IP takeover # -l Configure Layer2 support # -f Override safety checks # -t Valid cardtypes are: qeth, hsi - Deprecated # -o General QETH options, separated by spaces # -n QETH port number to use, 0 or 1. Only needed for real, not virtual # devices. # -p QETH Portname to use - Deprecated. OSAs no longer need a port name. # read/write/data chan = x.y.ssss where # x is always 0 until IBM creates something that # uses that number # y is the logical channel subsystem (lcss) # number. Most often this is 0, but it could # be non-zero # ssss is the four digit subchannel address of # the device, in hexidecimal, with leading # zeros. # online = 0 to take the device offline # 1 to bring the device online # # Return values: # Return codes are determined by the chzdev command. # mesg () { echo "$@" } debug_mesg () { case "${DEBUG}" in yes) mesg "$@" ;; *) ;; esac } add_cio_channel() { echo "$* # ${DATE}" >> /boot/zipl/active_devices.txt } remove_cio_channel() { [ -w /boot/zipl/active_devices.txt ] && sed -i -e "/^${1}/d" /boot/zipl/active_devices.txt } usage(){ echo "Usage: ${0} [options] " echo " -i Configure IP takeover" echo " -l Configure Layer2 support" echo " -f Override safety checks" echo " -t Valid cardtypes are: qeth, hsi - Deprecated." echo " -o General QETH options, separated by spaces" echo " -n QETH port number to use, 0 or 1. Only needed for real, not virtual" echo " devices." echo " -p QETH Portname to use - Deprecated. OSAs no longer need a port name." echo " read/write/data chan = x.y.ssss where" echo " x is always 0 until IBM creates something that" echo " uses that number" echo " y is the logical channel subsystem (lcss)" echo " number. Most often this is 0, but it could" echo " be non-zero" echo " ssss is the four digit subchannel address of" echo " the device, in hexidecimal, with leading" echo " zeros." echo " online = 0 to take the device offline" echo " 1 to bring the device online" } if [ "${DEBUG}" != "yes" ]; then DEBUG="no" fi DATE=$(date) ############################################################ # Parse the parameters from the command line # ARGS=$(getopt --options ifln:o:p:t: -n "qeth_configure" -- "$@") if [ $? != 0 ] ; then echo "Terminating..." >&2 ; exit 1 ; fi eval set -- "${ARGS}" debug_mesg "All the parms passed were ${ARGS}" # Set some defaults LAYER_MODE="layer2=0" while true; do case "${1}" in -i) debug_mesg "Configure IP takeover" PARM_LIST="${PARM_LIST} ipa_takeover/enable=1" shift 1 ;; -f) debug_mesg "This used to mean udev rules will always be generated." debug_mesg "For chzdev, it means safety checks will be overridden." debug_mesg "Kinda sorta the same thing, really." PARM_LIST="${PARM_LIST} -f" shift 1 ;; -l) debug_mesg "Configure Layer 2 support" LAYER_MODE="layer2=1" shift 1 ;; -n) debug_mesg "Set QETH port number to ${2}" PARM_LIST="${PARM_LIST} portno=${2}" shift 2 ;; -o) debug_mesg "Add the following arbitrary parms: ${2}" PARM_LIST="${PARM_LIST} ${2}" shift 2 ;; -p) debug_mesg "QETH Port name is no longer used, don't specify it: ${2}" shift 2 ;; -t) debug_mesg "This used to set the card type to ${2}" debug_mesg "Now it gets ignored." shift 2 ;; --) debug_mesg "Found the end of parms indicator: --" shift 1 break ;; *) debug_mesg "At the catch-all select entry" debug_mesg "What was selected was ${1}" shift 1 ;; esac done QETH_READ_CHAN=${1} QETH_WRITE_CHAN=${2} QETH_DATA_CHAN=${3} ON_OFF=${4} if [ -z "${QETH_READ_CHAN}" ] || [ -z "${QETH_WRITE_CHAN}" ] || [ -z "${QETH_DATA_CHAN}" ] || [ -z "${ON_OFF}" ]; then mesg "You didn't specify all the needed parameters." usage exit 1 fi if [ "${ON_OFF}" == 0 ]; then debug_mesg "chzdev -d qeth --no-root-update ${QETH_READ_CHAN}" chzdev -d qeth --no-root-update ${QETH_READ_CHAN} elif [ "${ON_OFF}" == 1 ]; then debug_mesg "chzdev -e qeth --no-root-update ${LAYER_MODE} ${PARM_LIST} ${QETH_READ_CHAN}" chzdev -e qeth ${LAYER_MODE} --no-root-update ${PARM_LIST} ${QETH_READ_CHAN} else mesg "You must specify a 0 or a 1 for the online/offline attribute." usage exit 1 fi RC=${?} if [ ${RC} -ne 0 ]; then exit ${RC} fi if [ ${ON_OFF} == 1 ]; then add_cio_channel "${QETH_READ_CHAN},${QETH_WRITE_CHAN},${QETH_DATA_CHAN}" else remove_cio_channel "${QETH_READ_CHAN}" remove_cio_channel "${QETH_WRITE_CHAN}" remove_cio_channel "${QETH_DATA_CHAN}" fi