99. Lan

Network card data

99.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

  • 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.

99.2. Global Functions

99.2.1. Add

Add a new device

Return value

  • boolean - true if success

99.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

99.2.3. AutoPackages

Return value

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

99.2.4. Autoinstall

Create a configuration for autoyast

Return value

  • boolean - true if something was proposed

99.2.5. Commit

Commit pending operation

Return value

  • boolean - true if success

99.2.6. Delete

Delete the given device

Function parameters

  • string name

Return value

  • boolean - true if success

99.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

99.2.8. Edit

Edit the given device

Function parameters

  • string name

Return value

  • boolean - true if success

99.2.9. Export

Export data

Return value

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

99.2.10. FreeAliases

Return 10 free aliases

Function parameters

  • string type

  • integer num

Return value

  • list - of 10 free devices

99.2.11. FreeDevices

Return 10 free devices

Function parameters

  • string type

Return value

  • list - of 10 free devices

99.2.12. GetModified

Function which returns if the settings were modified

Return value

  • boolean - settings were modified

99.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

99.2.14. HaveXenBridge

Xen bridging confuses us (#178848)

Return value

  • boolean - whether xenbr* exists

99.2.15. Import

Import data

Function parameters

  • map settings

Return value

  • boolean - true on success

99.2.16. Modified

Data was modified?

Return value

  • boolean - true if modified

99.2.17. Overview

Create an overview table with all configured devices

Return value

  • list - table items

99.2.18. Packages

Return value

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

99.2.19. Propose

Propose a configuration

Return value

  • boolean - true if something was proposed

99.2.20. ProposeInterfaces

Propose interface configuration

Return value

  • boolean - true if something was proposed

99.2.21. ProposeRoutesAndResolver

Propose configuration for routing and resolver

Return value

  • boolean - true if something was proposed

99.2.22. Read

Read all network settings from the SCR

Function parameters

  • symbol cache

Return value

  • boolean - true on success

99.2.23. ReadWithCache

(a specialization used when a parameterless function is needed)

Return value

  • boolean - Read(`cache)

99.2.24. Select

Select the given device

Function parameters

  • string dev

Return value

  • boolean - true if success

99.2.25. SelectHW

Select the hardware component

Function parameters

  • integer which

Return value

  • void

99.2.26. SetDefaultsForHW

must be in sync with @ref GetDefaultsForHW

Return value

  • void

99.2.27. SetModified

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

Return value

  • void

99.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

99.2.29. SummaryNM

Create a textual summary for the NetworkManager proposal

Return value

  • list - [rich text, links]

99.2.30. UnsetModified

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

Return value

  • void

99.2.31. Write

Update the SCR according to network settings

Return value

  • boolean - true on success

99.2.32. WriteOnly

Only write configuration without starting any init scripts and SuSEconfig

Return value

  • boolean - true on success

99.3. Global Variables

99.3.1. AbortFunction

Abort function return boolean return true if abort

99.3.2. hotplug

Hotplug type ("" if not hot pluggable)

99.3.3. operation

Which operation is pending?

99.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")

99.4. Module Requirements

99.4.1. Module Imports

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

99.4.2. Module Includes

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