110. Lan

Network card data

110.1. Summary of Module Globals

List of Global Functions

  • Add - Add a new device

  • AnyDHCPDevice - Check if any device except the current one is configured with DHCP. The current one is checked separately because there may be uncommitted changes. (#17391)

  • AutoPackages -

  • Autoinstall - Create a configuration for autoyast

  • Commit - Commit pending operation

  • Delete - Delete the given device

  • DriverType - For s390 hwinfo gives us a multitude of types but some are handled the same, mostly acording to the driver which is used. So let's group them under the name Driver Type.

  • Edit - Edit the given device

  • Export - Export data

  • FreeAliases - Return 10 free aliases

  • FreeDevices - Return 10 free devices

  • GetModified - Function which returns if the settings were modified

  • HasAliases - Check if the given device has any virtual alias.

  • HaveXenBridge - Xen bridging confuses us (#178848)

  • Import - Import data

  • Modified - Data was modified?

  • Overview - Create an overview table with all configured devices

  • Packages -

  • Propose - Propose a configuration

  • ProposeInterfaces - Propose interface configuration

  • ProposeRoutesAndResolver - Propose configuration for routing and resolver

  • Read - Read all network settings from the SCR

  • ReadWithCache - (a specialization used when a parameterless function is needed)

  • Select - Select the given device

  • SelectHW - Select the hardware component

  • SetDefaultsForHW - must be in sync with @ref GetDefaultsForHW

  • SetModified - Function sets internal variable, which indicates, that any settings were modified, to "true"

  • Summary - Create a textual summary and a list of unconfigured devices

  • SummaryIPv6 - Create a textual summary for the ipv6 proposal

  • SummaryNM - Create a textual summary for the NetworkManager proposal

  • UnsetModified - Function sets internal variable, which indicates, that any settings were modified, to "false"

  • Write - Update the SCR according to network settings

  • WriteOnly - Only write configuration without starting any init scripts and SuSEconfig

List of Global Variables

  • AbortFunction - Abort function return boolean return true if abort

  • hotplug - Hotplug type ("" if not hot pluggable)

  • operation - Which operation is pending?

  • wl_wpa_eap - wl_wpa_eap aggregates the settings in a map for easier CWM access.

110.2. Global Functions

110.2.1. Add

Add a new device

Return value

  • boolean - true if success

110.2.2. AnyDHCPDevice

Check if any device except the current one is configured with DHCP. The current one is checked separately because there may be uncommitted changes. (#17391)

Return value

  • boolean - true if any DHCP device except the current one is configured

110.2.3. AutoPackages

Return value

  • map - of packages needed when writing the config in autoinst mode

110.2.4. Autoinstall

Create a configuration for autoyast

Return value

  • boolean - true if something was proposed

110.2.5. Commit

Commit pending operation

Return value

  • boolean - true if success

110.2.6. Delete

Delete the given device

Function parameters

  • string name

Return value

  • boolean - true if success

110.2.7. DriverType

For s390 hwinfo gives us a multitude of types but some are handled the same, mostly acording to the driver which is used. So let's group them under the name Driver Type.

Function parameters

  • string type

Return value

  • string - driver type, like formerly type2 for s390

110.2.8. Edit

Edit the given device

Function parameters

  • string name

Return value

  • boolean - true if success

110.2.9. Export

Export data

Return value

  • map - dumped settings (later acceptable by Import())

110.2.10. FreeAliases

Return 10 free aliases

Function parameters

  • string type

  • integer num

Return value

  • list - of 10 free devices

110.2.11. FreeDevices

Return 10 free devices

Function parameters

  • string type

Return value

  • list - of 10 free devices

110.2.12. GetModified

Function which returns if the settings were modified

Return value

  • boolean - settings were modified

110.2.13. HasAliases

Check if the given device has any virtual alias.

Function parameters

  • string dev

Return value

  • boolean - true if there are some aliases

110.2.14. HaveXenBridge

Xen bridging confuses us (#178848)

Return value

  • boolean - whether xenbr* exists

110.2.15. Import

Import data

Function parameters

  • map settings

Return value

  • boolean - true on success

110.2.16. Modified

Data was modified?

Return value

  • boolean - true if modified

110.2.17. Overview

Create an overview table with all configured devices

Return value

  • list - table items

110.2.18. Packages

Return value

  • list<string> - of packages needed when writing the config

110.2.19. Propose

Propose a configuration

Return value

  • boolean - true if something was proposed

110.2.20. ProposeInterfaces

Propose interface configuration

Return value

  • boolean - true if something was proposed

110.2.21. ProposeRoutesAndResolver

Propose configuration for routing and resolver

Return value

  • boolean - true if something was proposed

110.2.22. Read

Read all network settings from the SCR

Function parameters

  • symbol cache

Return value

  • boolean - true on success

110.2.23. ReadWithCache

(a specialization used when a parameterless function is needed)

Return value

  • boolean - Read(`cache)

110.2.24. Select

Select the given device

Function parameters

  • string dev

Return value

  • boolean - true if success

110.2.25. SelectHW

Select the hardware component

Function parameters

  • integer which

Return value

  • void

110.2.26. SetDefaultsForHW

must be in sync with @ref GetDefaultsForHW

Return value

  • void

110.2.27. SetModified

Function sets internal variable, which indicates, that any settings were modified, to "true"

Return value

  • void

110.2.28. Summary

Create a textual summary and a list of unconfigured devices

Function parameters

  • string mode

Return value

  • list - summary of the current configuration

110.2.29. SummaryIPv6

Create a textual summary for the ipv6 proposal

Return value

  • list - [rich text, links]

110.2.30. SummaryNM

Create a textual summary for the NetworkManager proposal

Return value

  • list - [rich text, links]

110.2.31. UnsetModified

Function sets internal variable, which indicates, that any settings were modified, to "false"

Return value

  • void

110.2.32. Write

Update the SCR according to network settings

Return value

  • boolean - true on success

110.2.33. WriteOnly

Only write configuration without starting any init scripts and SuSEconfig

Return value

  • boolean - true on success

110.3. Global Variables

110.3.1. AbortFunction

Abort function return boolean return true if abort

110.3.2. hotplug

Hotplug type ("" if not hot pluggable)

110.3.3. operation

Which operation is pending?

110.3.4. wl_wpa_eap

wl_wpa_eap aggregates the settings in a map for easier CWM access.

wpa_eap
 WPA_EAP_MODE: string ("TTLS" "PEAP" or "TLS")
 WPA_EAP_IDENTITY: string
 WPA_EAP_PASSWORD: string (for TTLS and PEAP)
 WPA_EAP_ANONID: string (for TTLS and PEAP)
 WPA_EAP_CLIENT_CERT: string (for TLS, file name)
 WPA_EAP_CLIENT_KEY: string (for TLS, file name)
 WPA_EAP_CLIENT_KEY_PASSWORD: string (for TLS)
 WPA_EAP_CA_CERT: string (file name)
 WPA_EAP_AUTH: string ("", "MD5", "GTC", "CHAP"*, "PAP"*, "MSCHAP"*, "MSCHAPV2") (*: TTLS only)
 WPA_EAP_PEAP_VERSION: string ("", "0", "1")

110.4. Module Requirements

110.4.1. Module Imports

  • Arch
  • DNS
  • Detection
  • FileUtils
  • Host
  • Hostname
  • IP
  • Map
  • Mode
  • NetworkConfig
  • NetworkDevices
  • NetworkModules
  • NetworkService
  • NetworkStorage
  • Package
  • PackageSystem
  • ProductFeatures
  • Progress
  • Routing
  • Service
  • String
  • SuSEFirewall4Network
  • Summary

110.4.2. Module Includes

  • network/complex.ycp
  • network/hardware.ycp
  • network/install.ycp
  • network/routines.ycp
  • network/runtime.ycp
  • network/runtime.ycp