NAME

       pibrump - Classification Rule Dump Utility

SYNOPSIS

       pibrump [options] file [file] [...]

DESCRIPTION

       Read  classifier  rules  stored in a PIB file and print them on stdout in a format similar to the command
       line for program int6krule.  The output can be read by program pibruin for  insertion  into  another  PIB
       file.  The program name is short for "rule dump".

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

OPTIONS

       -q     Suppresses comments used to group classification rules.

       -v     Print additional information on stdout.  Presently, this option has no effect.

       -?,--help
              Print  program  help  summary  on  stdout.  This option takes precedence over other options on the
              command line.

       -!,--version
              Print program version information on stdout.  This option takes precedence over other  options  on
              the  command line.  Use this option when sending screen dumps to Atheros Technical Support so that
              they know exactly which version of the Linux Toolkit you are using.

ARGUMENTS

       file   The name of a valid Atheros runtime parameter file.  The file is not  modified  by  this  program.
              The  file  must  exist and be a valid runtime parameter file or errors will occur.  By convention,
              runtime parameter files have a .pib extention but this program does not enforce that convention.

DISCLAIMER

       PIB file structure and content is proprietary to Qualcomm Atheros, Ocala FL  USA.   Consequently,  public
       information  is  not  available.   Qualcomm  Atheros  reserves  the right to change the file structure or
       content in future firmware releases without any obligation to notify or compensate users of this program.

EXAMPLES

       The following example prints the classifier rules stored in file abc.pib on stdout.  Individual rules are
       printed in a format that is essentially the same as that used to enter  rules  using  program  int6krule.
       Rules are grouped by their category using comments.

          > pibrump abc.pib
          # auto connection rules:
          StripRX Any VLANID Is 5 VLANID Is 10 VLANID Is 15 add perm
          StripRX Any VLANID Is 20 add perm
          CAP1 Any VLANID Is 5 VLANID Is 10 VLANID Is 15 add perm
          # priority mapping rules:
          CAP1 Any VLANID Is 20 add perm
          DropRX Any VLANID Is 25 add perm

       The  next  example prints the classifier rules stored in file def.pib but output is a huge disappointment
       because there are no rules, much like a Rambo movie.

          > pibrump def.pib
          # auto connection rules:
          # priority mapping rules:

       The next example shows a case where the the user has selected two rules from the first example  and  used
       them  as  input to program int6krule.  There is no PIB file involved here because an MME is sent directly
       to the device with each command and the device will reset each time.  There are times when  you  may  not
       want to set rules this way.

          > int6krule StripRX Any VLANID Is 5 VLANID Is 10 VLANID Is 15 add perm
          # int6krule CAP1 Any VLANID Is 20 add perm

       The next example reads classification rules from file abc.pib and write them to file rules.txt instead of
       the  console.   The  rules  are then read from file rules.txt and written into file def.pib using program
       pibruin.  This procedure can be used to distribute a given rule set to other toolkit users.

          > pibrump abc.def > rules.txt
          # pibruin < rules.txt def.pib

       The next example reads classification rules directly from file abc.pib and writes them directly into file
       def.pib using program pibruin.

          > pibrump abc.pib | pibruin def.pib

SEE ALSO

       int6krule(7), pibruin(7)

CREDITS

        Nathaniel Houghton

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