bbppp - a ppp link manager for the Blackbox window manager

bbppp [options]

BBppp is part of the bbtools suite of programs, designed to be used with the Blackbox window manager. It is a ppp link manager (read "dialer), and in the minimalist spirit of Blackbox, was designed to take up very little real estate on your desktop, and few resources. However, it is flexible enough to even be configured as small as a single button. While it was designed for Blackbox, it can probably be used with any other window manager.

-c[onfig] <filename> Use <filename> as the resource file instead of /etc/bbtools/bbppp.*

-n[obb]

Fall back on default configuration.

-v[ersion]

Display the current version number of bbppp.

-h[elp]

Display a brief summary of options.

-d[ecorated]

Show a 'normal' decorated window.

-w[ithdrawn]

Place bbppp in the Slit (see blackbox(1) for description of the Slit)

-s[hape]

Don't display groundplate.

-thru[put]

Display the throughput pane. This pane displays the traffic across the ppp link, in kilobytes/s, updated every second. It calculates this value based on the aggregate statistics displayed in /proc/net/dev

-o, -orient <h|v>

Display the button[s], and pane[s] in either horizontal or vertical format. The default format is horizontal, where the components are lined up end-to-end. Vertical orientation stacks the components on top of each other, with the button at the top, and thruput window (if displayed) at the bottom.

-com[pact]

Display bbppp in compact mode. Essentially, combine the three buttons (on/off switch, transmit, receive) into a single button with three LEDs.

-notime

By default, bbppp shows the number of hours, minutes and seconds the link has been up. Using this switch prevents the uptime pane from being displayed.

-nosecs

When showing the link uptime use the old-style hh:mm format without showing the seconds.

Under Debian, the default configuration file for bbppp is /etc/bbtools/bbppp.bb , if you are running the blackbox window manager. Otherwise, bbppp uses /etc/bbtools/bbppp.nobb as default. If installing from source, these configuration files will most likely be found in the /usr/local/share/bbtools directory.

All the command-line options can be configured within the resource file, which is pretty much what you'd expect. The look and feel of bbppp is also configured here as well. By default, if running blackbox as your window manager, bbppp will pick up your currently-selected theme and dress itself to match. However, you can reconfigure this using the resource file.

Button colors can also be selected in the resource file, but most importantly, the start, stop and resume commands are specified here as well. Bbppp does not do the link management itself--it calls other programs to do the dirty work, such as ifup / ifdown or pppon / pppoff

The individual resources in bbppp.bb will not be described here in this manpage, since they are well-named and self-explanatory, and the version shipped with the source code and in the Debian package is commented well enough so that anyone with an ounce of sense in his head can figure it out.

/etc/bbtools/bbppp.bb

/etc/bbtools/bbppp.nobb

bbppp was written and maintained by John Kennis (jkennis@chello.nl). This manpage was written by Jon Franklin (yokkun@att.net) and updated by Florian Ernst (florian@debian.org).

The latest version of bbppp can be found at

http://bbtools.sourceforge.net/

The official Blackbox website is at

http://blackboxwm.sourceforge.net/

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

On Debian systems, the complete text of the GNU General Public License, version 2, can be found in /usr/share/common-licenses/GPL-2.

blackbox(1)