oracular (1) coqos_rel.1.gz

Provided by: plc-utils-extra_0.0.6+git20230504.1ba7d5a0-1_amd64 bug

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 "