SYNOPSIS

       bbsmount [options]

DESCRIPTION

       bbsmount  displays whether drives are mounted or not mounted and allows
       you to mount and umount them (you can execute any program,  too).   You
       must  set  in config file, which drives (mount points) bbsmount have to
       check. To (u)mount drive, you simply press mouse button on it. Command,
       that is executed on user action can be customized.

       The  tool is designed to mimic the look and feel of the Blackbox window
       manager when used in combination  with  blackbox  bbsmount  copies  the
       style from Blackbox.

OPTIONS

       bbsmount supports the following command line options:

       -d displayname
              Set display to displayname

       -c[onfig] configname
              Read configuration from configname instead of the default.

       -n[obb]
              Fall back on default configuration

       -v[ersion]
              Display version number of bbsmount

       -h[elp]
              Display help on command line options

       -geom[etry] +x+y
              Set  the  position  of  bbsmount to x,y. Use +x+y to specify the
              coordinates relative to the upper left corner, use -x-y  specify
              the coordinates relative the lower right corner.  This option is
              ignored when -withdrawn flag is used.

       -d[ecorated]
              Show bbsmount in a normal window with title bar.

       -w[ithdrawn]
              Put bbsmount in the blackbox slit or Windowmaker dock.

       -s[hape]
              Don't display the background of bbsmount. This only makes  sense
              in combination with the -withdrawn flag

CONFIGURATION

       Global configuration: By default the configuration file bbsmount.bb can
                     Set number of rows.

              bbsmount.column.width:  width
                     Set width of button.

              bbsmount.row.height:  height
                     Set height of button.

              bbsmount.position:  +x+y
                     Set position of bbsmount.

              bbsmount.withdrawn: boolean
                     Set  to True to put bbsmount in the blackbox slit or Win-
                     dowmaker dock.  Default set to false.

              bbsmount.shape:boolean
                     Set to True if bbsmount shouldn't display its background.
                     This  gives a nice effect when withdrawn.  Default set to
                     false.

              bbsmount.checkDelay: seconds
                     Delay between checks. After delay bbsmount scans the mtab
                     for mounted drives.

              bbsmount.mount: gradient
                     Set the gradient of the button.  Example: Raised Gradient
                     Vertical Bevel1

              bbsmount.mount.color: color
                     Set the "from" color of the button.

              bbsmount.mount.colorTo: color
                     Set the "to" color of the button.

              bbsmount.mount.pressed: gradient
                     Set the gradient of the button  when  pressed.   Example:
                     Raised Gradient Vertical Bevel1

              bbsmount.mount.pressed.color: color
                     Set the "from" color of the pressed button.

              bbsmount.mount.pressed.colorTo: color
                     Set the "to" color of the pressed button.

              bbsmount.debuglevel: number
                     Set debug level to number.

              bbsmount.ImagePrefix: path
                     Search here for images.


       Resources definitions
                     Commands from 1 to N are defined. You can write here any-
                     thing  what  can be interpreted by shell. If there is one
                     '%s' in command, it is substitued by mount point. If  you
                     want to define command with char '%' you must write %%.

              bbsmount.infotext1: tooltip text

              ...

              bbsmount.infotextN: tooltip text
                     Tooltip texts from 1 to N are defined. You can write here
                     any text with printf-like specificators. If you  want  to
                     add newline use '\n'.


       Mount points definitions

              bbsmount.mountM: mount point
                     Set mount point value for M-th button.

              bbsmount.mountM.mountedImage: image number
                     Set image shown when M-th mount point is mounted.

              bbsmount.mountM.notMountedImage: image number
                     Set image shown when M-th mount point is not mounted.

              bbsmount.mountM.mountedText: infotext number
                     Set  text  shown  in  tooltip  when  M-th  mount point is
                     mounted.

              bbsmount.mountM.notMountedText: infotext number
                     Set text shown in tooltip when M-th mount  point  is  not
                     mounted.

              bbsmount.mountM.errorText: infotext number
                     Set  text shown in tooltip when there was error (executed
                     command returns non-zero value).

              bbsmount.mountM.description: text
                     Set mount point description. This value can  be  used  in
                     tooltip text.

              bbsmount.mountM.actionN.command: command number
                     Run  this  command  when actionN occurs. If there are two
                     numbers, the first command is executed when  mount  point
                     is not mounted and second otherwise.

              bbsmount.mountM.actionN.button: button number
                     When  user  press this mouse button, then this action can
                     be started.

              bbsmount.mountM.actionN.modifiers: modifiers

       SIGUSR1
              Bbsmount reconfigure itself.

       SIGINT Bbsmount frees all used resources and then exits.

       SIGTERM
              Same as previous signal.

AUTHORS

       Written  by Miroslav Jezbera. Some parts of code are taken from bbdate,
       bbmail, blackbox.

REPORTING BUGS

       Report bugs to <jezberam@phoenix.inf.upol.cz>.

SEE ALSO

       blackbox(1), mount(8)



Miroslav Jezbera                 Jul  4, 2004                      bbsmount(1)