NAME

       plainbox.conf - plainbox configuration file

SYNOPSIS

       /etc/xdg/plainbox.conf

       $XDG_CONFIG_HOME/plainbox.conf

DESCRIPTION

       Plainbox  (and its derivatives) uses a configuration system composed of variables arranged
       in sections. All  configuration  files  follow  the  well-known  INI-style  syntax.  While
       Plainbox itself is not really using any variables, knowledge of where those can be defined
       is useful for working with derivative applications, such as Checkbox.

   The [environment] section
       The [environment] section deserves  special  attention.  If  a  job  advertises  usage  of
       environment  variable FOO (by using the environ: FOO declaration) and FOO is not available
       in the environment of the user starting plainbox, then the  value  is  obtained  from  the
       [environment]  section.  This  mechanism  is  useful  for  distributing both site-wide and
       per-user configuration for jobs.

FILES

       /etc/xdg/plainbox.conf
          System-wide configuration file (lowest priority).

       $XDG_CONFIG_HOME/plainbox.conf
          Per-user configuration (highest priority).

EXAMPLES

       /etc/xdg/plainbox.conf:

          [environment]
          OPEN_BG_SSID=my-ap-ssid

SEE ALSO

       plainbox-check-config (1)

AUTHOR

       Zygmunt Krynicki & Checkbox Contributors

COPYRIGHT

       2012-2014 Canonical Ltd