Rechercher une page de manuel
beagle-config
Langue: en
Version: July 2008 (fedora - 04/07/09)
Section: 1 (Commandes utilisateur)
Sommaire
NAME
beagle-config - command-line interface to Beagle configurationSYNOPSIS
beagle-config optionsbeagle-config sections
beagle-config sections section-options [params]
beagle-config xml-options
DESCRIPTION
beagle-config is a command line tool designed to manipulate the Beagle configuration.The configuration is stored in a series of files usually located in the ~/.beagle/config directory. The configuration is split up into sections, each section being represented by 1 file.
The format used is the result of serialized objects. Manually modifying the configuration files is not recommended, you should use this utility instead. You can also the graphical interfaces beagle-settings (Gtk) or beagle-settings-qt (Qt4).
Each section configures a different area of the Beagle system. Each section has a number of preset section-options (commands) which you can perform on it via this command-line application.
The available sections, and available options for each section, are discovered at runtime. This manual does not attempt to document the sections in detail. This manual demonstrates how you can retrieve a list of available sections and their options.
beagle-config can be used "offline", it does not require a Beagle daemon to be running for most operations. If a Beagle daemon is running, it will immediately be notified of any configuration changes, and your new settings will come into effect almost immediately. Alternatively, you can force a re-load with the --beagled-reload-config argument.
OPTIONS
- --help
- Print a brief copyright and usage message.
- --beagled-reload-config
- Asks the beagle daemon to reload the configuration files.
- --list-sections
- Lists all of the available sections for use as the sections parameter.
- --version
- Print version information.
SECTION OPTIONS
Each section has its own unique set of options available. To see a list of supported options for a particular section, run beagle-config section-name with no additional parameters. Note that some of the options are strictly for internal usage by beagle and should not be modified by the user.PARAMS
To read the value of section-option, you do not need to give any params. Of course you need to supply params if you want to set a section-option. There are 3 types of section options. The params depend on the type of the section-option.- boolean option
- PARAMS is "true" or "false"
- string option
- PARAMS is the value of the section-option.
- list option
- To add a list option, pass a comma separated list of options value1,value2,.... Run beagle-config section-name section-option for the number of items in the list and their explanations.
To remove a list option, pass - value1,value2,... where value1,value2,... are the exact values of the option that you want to remove.
XML OPTIONS
Non-C# programs who want to get/set configuration values can use these options. If an error occurs, the return value can be checked to determine the kind of the error. The return value is- 1: Bad section name
- 2: Invalid XML
- 3: XML does not correspond to the section name
Options
- --read-xml SECTION
- Reads the xml of a section from stdin. Suitable for setting options by other programs.
- --write-xml SECTION
- Print the section in xml format. Suitable for parsing by other programs.
AUTHOR
Originally written by Daniel Drake <dsd@gentoo.org>. Modified by D Bera <dbera.web@gmail.com>REPORTING BUGS
Report bugs to <dashboard-hackers@gnome.org>.COPYRIGHT
Copyright © 2005 Novell, Inc., © 2008 D BeraThis is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
SEE ALSO
beagled(1)Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre