• NAME
• SYNTAX
• DESCRIPTION
• OPTIONS
• ARGUMENTS
• EXIT-VALUES
• SEE ALSO
• AUTHOR
• COPYRIGHT

.

NAME

ctys-xen-network-bridge - adapted from the original script

SYNTAX

ctys-xen-network-bridge

    ctys-xen-network-bridge [options] [<action-arguments>] 

DESCRIPTION

ctys-xen-network-bridge is copied and adapted from the original script of Xen-3.0.3-25.0.4.el5 from CentOS-5.0 distribution for the UnifiedSessionsManager. This is preferred as an exceptional case, instead of a patch, because almost any second line is changed, even though for trace mainly. The intention is not to take ownership or claim any rights. The adaptation was neccessary, mainly due to debugging issues as an integral part for setting up WoL by PM, requiring a previous re-ordering and re-configuration of the IF targeted by WoL packets. The usage of the provided standard tool for Xen-ified machines was just the natural step. Anyhow, should be obsolete, when the so called MAGIC-PACKET(TM) could be set on a vif, other WoL-attributes, such as broadcast, seems to work already.

• Copyright (C) by Owners of Xen
• Copyright (C) by Owners of CentOS
• Copyright (C) by RedHat Inc.

It is adapted in order of simplification of access grant for userland access. For ctys the "stop" case only is required when WoL has to be activated, thus this is the only verified call interface for now: ```network-bridge stop bridge=<bridge-to-stop> netdev=<netdev>

This will be compatible for an immediate switch-over to the original script, when preferred. Some minor patches for suppression of debugging flags might be required. For application and manual call the following has to be supported:

• if appropriate: call only as root, than anthing might be ok.
• if user land required:
  • set access bits for each PATH part of group for

      /etc/xen/scripts/network-bridge
    

  • assure ksu/sudo for at least:

      ip, ifup, brctl
    

Because this is just an error-workaround, for erroneous setting of "wol g" by ethtool, it may be removed later. For additional information refer to Xen documentation.

.

OPTIONS

ctys-xen-network-bridge

All options are "optional".

bridge=<virtual-bridge>

The name of the virtual bridge to stop, for Xen this is frequently "xenbr0."

netdev=<original-network-device>

The name of the interface to stop, for Xen this is frequently "eth0" or "bond0".

vifnum=<virtual-netdev-num>

Normally not required, else frequently this is "0".

.

ARGUMENTS

Standard init argument.

• status
  Standard init argument.

• stop
  Standard init argument.

.

EXIT-VALUES

0: OK:

Result is valid.

1: NOK:

Erroneous parameters.

2: NOK:

Missing an environment element like files or databases.

SEE ALSO

ffs.

AUTHOR

Written and maintained by Arno-Can Uestuensoez:

COPYRIGHT

Copyright (C) 2008, 2009, 2010, 2011 Ingenieurbuero Arno-Can Uestuensoez

For BASE package following licenses apply,

• for software see GPL3 for license conditions,
• for documents see GFDL-1.3 with invariant sections for license conditions,

This document is part of the DOC package,

• for documents and contents from DOC package see
  'Creative-Common-Licence-3.0 - Attrib: Non-Commercial, Non-Deriv'
  
  
  with optional extensions for license conditions.

For additional information refer to enclosed Releasenotes and License files.