pibrump(1)

💅 pibrump(1) — bestie edition ✨

okay so first things first: this is a page from the Qualcomm Atheros Open Powerline Toolkit manual set, and the star of the show is pibrump(1). Let's get into it 🫶

🌸 NAME 🌸

pibrump — the Classification Rule Dump Utility. yes bestie, it dumps rules. that's the whole vibe 💖

✨ SYNOPSIS ✨

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

🦋 DESCRIPTION 🦋

So what it does is: it reads the classifier rules that are chilling inside a PIB file, and it prints them on stdout in a format that's basically the same as the command line for the program int6krule. iconic behaviour honestly.

The output can then be read by the program pibruin so those rules get inserted into another PIB file. passing the baton, main character energy 🎀

The program name is short for "rule dump". iykyk.

This program is part of the Qualcomm Atheros Powerline Toolkit. Peep the AMP man page for an overview and installation instructions — it's giving required reading, ngl.

🔥 OPTIONS 🔥

• -q — Suppresses comments used to group classification rules. (the little group-chat labels? gone. silent mode fr fr)
• -v — Print additional information on stdout. Presently, this option has no effect. not me adding a flag that literally does nothing 😭 lowkey iconic of it
• -?, --help — Print program help summary on stdout. This option takes precedence over other options on the command line. it's the boss of the command line, periodt 👑
• -!, --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. pls do this bestie, the support girlies need the version number 💀

🍓 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. so like... name it whatever, but the vibes say .pib 💜

💀 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.

okay so that one's serious. proprietary, no public info, they can change it whenever, no notice, no compensation. not the group chat being read-only 🙈

🌈 EXAMPLES 🌈

Example the first — 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

Example the second — 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:

Example the third — 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

Example the fourth — 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

Example the fifth — reads classification rules directly from file abc.pib and writes them directly into file def.pib using program pibruin. pipe queen behaviour, we love to see it 🫶

> pibrump abc.pib | pibruin def.pib

🎀 SEE ALSO 🎀

• int6krule(7)
• pibruin(7)

⭐ CREDITS ⭐

• Nathaniel Houghton

k that's the whole page bestie 💖 it's from open-plc-utils-0.0.3, dated November 2013, and that's pibrump(1) — dump those rules, slay, and hydrate ✨🌸💅