25.3.2. Adding an LCS Device

The LAN channel station (LCS) device driver supports 1000Base-T Ethernet on the OSA-Express2 and OSA-Express 3 features.
Based on the type of interface being added, the LCS driver assigns one base interface name:
  • ethn for OSA-Express Fast Ethernet and Gigabit Ethernet
n is 0 for the first device of that type, 1 for the second, and so on.

25.3.2.1. Dynamically Adding an LCS Device

  1. Load the device driver: 
    # modprobe lcs
  2. Use the cio_ignore command to remove the network channels from the list of ignored devices and make them visible to Linux: 
    # cio_ignore -r read_device_bus_id,write_device_bus_id
    Replace read_device_bus_id and write_device_bus_id with the two device bus IDs representing a network device. For example: 
    # cio_ignore -r 0.0.09a0,0.0.09a1
  3. Create the group device: 
    # echo read_device_bus_id,write_device_bus_id > /sys/bus/ccwgroup/drivers/lcs/group
  4. Configure the device. OSA cards can provide up to 16 ports for a single CHPID. By default, the LCS group device uses port 0. To use a different port, issue a command similar to the following: 
    # echo portno > /sys/bus/ccwgroup/drivers/lcs/device_bus_id/portno
    Replace portno with the port number you want to use. For more information about configuration of the LCS driver, refer to the chapter on LCS in Linux on System z Device Drivers, Features, and Commands on Red Hat Enterprise Linux 6.
  5. Set the device online: 
    # echo 1 > /sys/bus/ccwgroup/drivers/lcs/read_device_bus_id/online
  6. To find out what network device name has been assigned, enter the command: 
    # ls -l /sys/bus/ccwgroup/drivers/lcs/read_device_bus_ID/net/
drwxr-xr-x 4 root root 0 2010-04-22 16:54 eth1