??????????????
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 173
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 174
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 175
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 176
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 177
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 178
ó
àUdac @` s d d l m Z m Z m Z e Z i d d 6d g d 6d d 6Z d Z d Z d
Z d d l
Z
d d l Z d Z
y d d l Z e Z Wn# e k
r« e j ƒ Z
e Z n Xd d l m Z m Z d
e f d „ ƒ YZ d e f d „ ƒ YZ d „ Z e d k r
e ƒ n d S( i ( t absolute_importt divisiont print_functions 1.1t metadata_versiont previewt statust communityt supported_bysñ
module: dconf
author:
- "Branko Majic (@azaghal)"
short_description: Modify and read dconf database
description:
- This module allows modifications and reading of dconf database. The module
is implemented as a wrapper around dconf tool. Please see the dconf(1) man
page for more details.
- Since C(dconf) requires a running D-Bus session to change values, the module
will try to detect an existing session and reuse it, or run the tool via
C(dbus-run-session).
notes:
- This module depends on C(psutil) Python library (version 4.0.0 and upwards),
C(dconf), C(dbus-send), and C(dbus-run-session) binaries. Depending on
distribution you are using, you may need to install additional packages to
have these available.
- Detection of existing, running D-Bus session, required to change settings
via C(dconf), is not 100% reliable due to implementation details of D-Bus
daemon itself. This might lead to running applications not picking-up
changes on the fly if options are changed via Ansible and
C(dbus-run-session).
- Keep in mind that the C(dconf) CLI tool, which this module wraps around,
utilises an unusual syntax for the values (GVariant). For example, if you
wanted to provide a string value, the correct syntax would be
C(value="'myvalue'") - with single quotes as part of the Ansible parameter
value.
- When using loops in combination with a value like
:code:`"[('xkb', 'us'), ('xkb', 'se')]"`, you need to be aware of possible
type conversions. Applying a filter :code:`"{{ item.value | string }}"`
to the parameter variable can avoid potential conversion problems.
- The easiest way to figure out exact syntax/value you need to provide for a
key is by making the configuration change in application affected by the
key, and then having a look at value set via commands C(dconf dump
/path/to/dir/) or C(dconf read /path/to/key).
version_added: "2.4"
options:
key:
required: true
description:
- A dconf key to modify or read from the dconf database.
value:
required: false
description:
- Value to set for the specified dconf key. Value should be specified in
GVariant format. Due to complexity of this format, it is best to have a
look at existing values in the dconf database. Required for
C(state=present).
state:
required: false
default: present
choices:
- read
- present
- absent
description:
- The action to take upon the key/value.
s
value:
description: value associated with the requested key
returned: success, state was "read"
type: str
sample: "'Default'"
s7
- name: Configure available keyboard layouts in Gnome
dconf:
key: "/org/gnome/desktop/input-sources/sources"
value: "[('xkb', 'us'), ('xkb', 'se')]"
state: present
- name: Read currently available keyboard layouts in Gnome
dconf:
key: "/org/gnome/desktop/input-sources/sources"
state: read
register: keyboard_layouts
- name: Reset the available keyboard layouts in Gnome
dconf:
key: "/org/gnome/desktop/input-sources/sources"
state: absent
- name: Configure available keyboard layouts in Cinnamon
dconf:
key: "/org/gnome/libgnomekbd/keyboard/layouts"
value: "['us', 'se']"
state: present
- name: Read currently available keyboard layouts in Cinnamon
dconf:
key: "/org/gnome/libgnomekbd/keyboard/layouts"
state: read
register: keyboard_layouts
- name: Reset the available keyboard layouts in Cinnamon
dconf:
key: "/org/gnome/libgnomekbd/keyboard/layouts"
state: absent
- name: Disable desktop effects in Cinnamon
dconf:
key: "/org/cinnamon/desktop-effects"
value: "false"
state: present
N( t
AnsibleModulet missing_required_libt DBusWrapperc B` s) e Z d Z d „ Z d „ Z d „ Z RS( ss
Helper class that can be used for running a command with a working D-Bus
session.
If possible, command will be run against an existing D-Bus session,
otherwise the session will be spawned via dbus-run-session.
Example usage:
dbus_wrapper = DBusWrapper(ansible_module)
dbus_wrapper.run_command(["printenv", "DBUS_SESSION_BUS_ADDRESS"])
c C` sD | | _ | j ƒ | _ | j d k r@ | j j d d t ƒn d S( sµ
Initialises an instance of the class.
:param module: Ansible module instance used to signal failures and run commands.
:type module: AnsibleModule
s dbus-run-sessiont requiredN( t modulet _get_existing_dbus_sessiont dbus_session_bus_addresst Nonet get_bin_patht True( t selfR ( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyt __init__™ s c C` s' t j ƒ } | j j d | ƒ xð t j ƒ D]â } t j | ƒ } | j ƒ \ } } } y¡ | | k r÷ d | j ƒ k r÷ | j ƒ d } | j j d | ƒ d d | d d d g } | j j | ƒ \ } } } | d k r÷ | j j d
| ƒ | Sn Wq- t j
k
rq- Xq- W| j j d ƒ d S(
s¿
Detects and returns an existing D-Bus session bus address.
:returns: string -- D-Bus session bus address. If a running D-Bus session was not detected, returns None.
s9 Trying to detect existing D-Bus user session for user: %dt DBUS_SESSION_BUS_ADDRESSs1 Found D-Bus user session candidate at address: %ss dbus-sends --address=%ss
--type=signalt /s com.example.testi s> Verified D-Bus user session candidate as usable at address: %ssD Failed to find running D-Bus user session, will use dbus-run-sessionN( t ost getuidR t debugt psutilt pidst Processt uidst environt run_commandt AccessDeniedR ( R t uidt pidt processt process_real_uidt _t" dbus_session_bus_address_candidatet commandt rc( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyR
¬ s$ c C` s½ | j d k r | j j d ƒ d g | } | j j | ƒ \ } } } | j d k r° | d k r° | j j d d | ƒ q° n1 i | j d 6} | j j | d | ƒ\ } } } | | | f S( sþ
Runs the specified command within a functional D-Bus session. Command is
effectively passed-on to AnsibleModule.run_command() method, with
modification for using dbus-run-session if necessary.
:param command: Command to run, including parameters. Each element of the list should be a string.
:type module: list
:returns: tuple(result_code, standard_output, standard_error) -- Result code, standard output, and standard error from running the command.
s4 Using dbus-run-session wrapper for running commands.s dbus-run-sessioni t msgsM Failed to run passed-in command, dbus-run-session faced an internal error: %sR t environ_updateN( R R R R R t fail_json( R R& R' t outt errt extra_environment( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyR Ò s
!( t __name__t
__module__t __doc__R R
R ( ( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyR
‹ s &t DconfPreferencec B` s/ e Z e d „ Z d „ Z d „ Z d „ Z RS( c C` s | | _ | | _ d S( sG
Initialises instance of the class.
:param module: Ansible module instance used to signal failures and run commands.
:type module: AnsibleModule
:param check_mode: Specify whether to only check if a change should be made or if to actually make a change.
:type check_mode: bool
N( R t
check_mode( R R R2 ( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyR î s c C` sx d d | g } | j j | ƒ \ } } } | d k rP | j j d d | ƒ n | d k re d } n | j d ƒ } | S( s
Retrieves current value associated with the dconf key.
If an error occurs, a call will be made to AnsibleModule.fail_json.
:returns: string -- Value assigned to the provided key. If the value is not set for specified key, returns None.
t dconft readi R( s3 dconf failed while reading the value with error: %st s
N( R R R* R t rstrip( R t keyR& R' R+ R, t value( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyR4 ü s c C` s‰ | | j | ƒ k r t S| j r& t Sd d | | g } t | j ƒ } | j | ƒ \ } } } | d k r… | j j d d | ƒ n t S( sË
Writes the value for specified key.
If an error occurs, a call will be made to AnsibleModule.fail_json.
:param key: dconf key for which the value should be set. Should be a full path.
:type key: str
:param value: Value to set for the specified dconf key. Should be specified in GVariant format.
:type value: str
:returns: bool -- True if a change was made, False if no change was required.
R3 t writei R( s1 dconf failed while write the value with error: %s( R4 t FalseR2 R R
R R R* ( R R7 R8 R& t dbus_wrapperR' R+ R, ( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyR9 s c C` sŒ | j | ƒ } | d k r t S| j r, t Sd d | g } t | j ƒ } | j | ƒ \ } } } | d k rˆ | j j d d | ƒ n t S( sV
Returns value for the specified key (removes it from user configuration).
If an error occurs, a call will be made to AnsibleModule.fail_json.
:param key: dconf key to reset. Should be a full path.
:type key: str
:returns: bool -- True if a change was made, False if no change was required.
R3 t reseti R( s4 dconf failed while reseting the value with error: %sN( R4 R R: R2 R R
R R R* ( R R7 t
current_valueR& R; R' R+ R, ( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyR< 7 s
( R. R/ R: R R4 R9 R< ( ( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyR1 ì s $c C` sž t d t d t d d d d d d g ƒ d t d t d
d ƒ d t d t d d d
d ƒ ƒ d
t ƒ } t s‹ | j d t d ƒ d t ƒ n | j d d k rÄ | j d d k rÄ | j d d ƒ n t
| | j ƒ } | j d d k r| j | j d ƒ } | j
d t d | ƒ n‚ | j d d k r^| j | j d | j d ƒ } | j
d | ƒ n< | j d d k rš| j | j d ƒ } | j
d | ƒ n d S( Nt
argument_spect statet defaultt presentt choicest absentR4 R7 R t typet strR8 t supports_check_modeR( R t exceptions+ State "present" requires "value" to be set.t changed( R t dictR R: R t psutil_foundR* R t PSUTIL_IMP_ERRt paramsR1 R2 R4 t exit_jsonR9 R< ( R R3 R8 RH ( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyt main\ s( & t __main__( t
__future__R R R RD t
__metaclass__t ANSIBLE_METADATAt
DOCUMENTATIONt RETURNt EXAMPLESR t tracebackR RK R R RJ t ImportErrort
format_excR: t ansible.module_utils.basicR R t objectR
R1 RN R. ( ( ( s@ /usr/lib/python2.7/site-packages/ansible/modules/system/dconf.pyt s,
;*
ap !