guru> ./twiddle-interface --help
twiddle-interface v1.4.0

  See /home/netops/etc/netops-global-config (and /home/netops/etc/netops-alarm-c
onfig if this is an
  xxxx-alarm script) for configuration options

  Usage:  twiddle-interface -s {yes|no} [-d {integer}] -a [enable|disable|flip|t
oggle] [-p {number of seconds to pause in the middle of a toggle}] -h {switch na
me} -i {interface name} [-n {number of repetitions} [-v xxxx] -w {number of seco
nds to wait before continuing with the next repetition}]

    -s asks the question:  are you serious?  If you answer 'no', then 
       the script will run in demo mode, making no changes

    -d specifies debug level (typically 0-9)

    -a specifies the action, which translates into the administrative state 
       into which the script will place this interface.  Actions include 
       the following:

       enable|noshut|up      Set administrative state to 'up'
       disable|shut|down|dn  Set administrative state to 'down'
       flip                  Change the administrative state to its opposite
                             (if the interface is currently 'up', then set it 
                             to 'down', and the converse)
       toggle                Change the administrative state to its opposite, 
                             wait a few seconds, and then change it back to 
                             its original state.  If a VLAN is specified, then 
                             change VLAN membership to that VLAN, wait a few 
                             seconds, then change it back

    -p specifies the number of seconds to pause between actions when 
       toggling.  Only applies if the action is 'toggle'; ignored otherwise

    -h specifies the name of the switch

    -i specifies the name of the interface, e.g. Gi3/1 or FastEthernet2/48 or 
       Vlan50 or Vl50 or v50

    -n specifies the number of times to repeat the action

    -v specifies the Vlan to which we will assign this interface.  If 
       specified, then the only valid actions are 'null' and 'toggle'

    -w specifies the number of seconds to pause between each repetition

    -y points to the alarm config file, only relevant to xxxx-alarm scripts.
       The default is /home/netops/etc/netops-alarm-config

    -z points to the global config file.  The default is
       /home/netops/etc/netops-global-config

guru>