NAME

       coqos_rel - Release Bandwidth Management

SYNOPSIS

       coqos_rel [options] cid [device] [...]

DESCRIPTION

       This page is under construction.

       Instructs  one  or more devices to stop managing a stream.  Use this program when bandwidth management is
       no longer needed or wanted.  Use program coqos_mod to  suspend  and  resume  bandwidth  management  of  a
       stream.

       This program is part of the Qualcomm Atheros Powerline Toolkit.  See the plc man page for an overview and
       installation instructions.

OPTIONS

       -e     Redirects  stderr  messages  to  stdout.   By  convention status and error messages are printed on
              stderr while primary program output is printed on stdout.  This option prints all output on stdout
              in cases where this is desired.

       -i interface
              Select the host Ethernet interface.  All requests are  sent  via  this  host  interface  and  only
              reponses  received  via this host interface are recognized.  The default interface is eth1 because
              most people use eth0 as their principle network connection; however, if environment  string  "PLC"
              is defined then it takes precedence over the default interface.  This option then takes precedence
              over either default.

       -q     Suppresses status messages on stderr.

       -r     Display relative memory offsets on output.  This option is the default.

       -v     Prints  additional  information  on  stdout.   In  particular, this option dumps outgoing Ethernet
              packets on stdout.

       -?,--help
              Displays program help information on stderr.  This option takes precedence over all other  options
              on the command line except version information.

       -!,--version
              Displays  program  version  information  on  stderr.   This option takes precedence over all other
              options on the command line except help information.  Use this option when sending screen dumps to
              Atheros technical staff.

ARGUMENTS

       cid    The connection identifier of the affected stream.

       device The MAC address of some powerline device.  More than one address may be specified on  the  command
              line.  If more than one address is specified then operations are performed on each device in turn.
              The default address is "local".  See DEVICES for more information.

DEVICES

       Ethernet  MAC  addresses  are  expressed  as  six  hexadecimal octets optionally separated by colon.  For
       example, the Qualcomm Atheros Local Management Address (LMA) of "00b052000001" may  also  be  entered  as
       "00:b0:52:00:00:01"  or  "00b052:000001".   Addresses  are  case insensitive and quotes are optional.  In
       addition, some special addresses may be  entered  by  name  rather  than  number  where  names  are  case
       sensitive.

       all    A synonym for the "broadcast" address, described next.

       broadcast
              A  synonym  for  the  Ethernet  broadcast address, FF:FF:FF:FF:FF:FF.  All devices, whether local,
              remote or foreign will respond to this address.

       local  A  synonym  for  the  Qualcomm  Atheros  vendor   specific   Local   Management   Address   (LMA),
              00:B0:52:00:00:01.   All  local  Atheros  devices  recognize  this  address but remote and foreign
              devices do not.  A remote device is any device at the  far  end  of  a  powerline  connection.   A
              foreign device is any device not manufactured by Atheros.

REFERENCES

       See the Qualcomm Atheros HomePlug AV Firmware Technical Reference Manual for more information.

DISCLAIMER

       Atheros  HomePlug  AV Vendor Specific Management Message structure and content is proprietary to Qualcomm
       Atheros, Ocala FL USA.  Consequently, public information may not be available.  Qualcomm Atheros reserves
       the right to modify message structure and content in future firmware releases without any  obligation  to
       notify or compensate users of this program.

EXAMPLES

       The  next  example  instructs  device 00:B0:52:BA:BE"01 to release stream 803. The stream will the remain
       unmanaged indefinitely.

          # coqos_rel 803 00:B0:52:BA:BE:01

SEE ALSO

       coqos_add(1), coqos_info(1), coqos_man(1), coqos_mod(1)

CREDITS

        Bill Wike
        Nathaniel Houghton
        Charles Maier "

open-plc-utils-0.0.3                              November 2013                                     coqos_rel(1)