bbppp(1)                    General Commands Manual                   bbppp(1)

       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

              Fall back on default configuration.

              Display the current version number of bbppp.

              Display a brief summary of options.

              Show a 'normal' decorated window.

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

              Don't display groundplate.

              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.

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

              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.

              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/ , 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 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.


       bbppp was written and maintained by John Kennis (
       This manpage was written by Jon Franklin ( and updated
       by Florian Ernst (

       The latest version of bbppp can be found at

       The official Blackbox website is at

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


0.2.5                            July 08, 2004                        bbppp(1)