Current File : //lib/python2.7/site-packages/salt/beacons/bonjour_announce.pyo
�
���^c @@ s� d Z d d l m Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m
Z
d d l m Z y d d l
Z
e Z Wn e k
r� e Z n Xe j e � Z d Z i a d a d � Z d � Z d � Z d
� Z d � Z d � Z d S(
s+
Beacon to announce via Bonjour (zeroconf)
i ( t absolute_importN( t six( t mapt bonjour_announcec C@ s t r
t St S( N( t
HAS_PYBONJOURt __virtualname__t False( ( ( sA /usr/lib/python2.7/site-packages/salt/beacons/bonjour_announce.pyt __virtual__ s c C@ s t r t j � d a n d S( sS
Close the SD_REF object if it isn't NULL
For use with atexit.register
N( t SD_REFt closet None( ( ( sA /usr/lib/python2.7/site-packages/salt/beacons/bonjour_announce.pyt
_close_sd_ref& s
c C@ s& | t j k r" t j d | � n d S( Ns. Bonjour registration failed with error code %s( t pybonjourt kDNSServiceErr_NoErrort logt error( t sdReft flagst errorCodet namet regtypet domain( ( sA /usr/lib/python2.7/site-packages/salt/beacons/bonjour_announce.pyt _register_callback1 s c @ se i � t t � j | � � t | t � s5 t d f St � f d � d D� � s[ t d f St d f S( s+
Validate the beacon configuration
s9 Configuration for bonjour_announce beacon must be a list.c 3@ s | ] } | � k Vq d S( N( ( t .0t x( t _config( sA /usr/lib/python2.7/site-packages/salt/beacons/bonjour_announce.pys <genexpr>A s t servicetypet portt txtsW Configuration for bonjour_announce beacon must contain servicetype, port and txt items.s Valid beacon configuration.( R s ports txt( t listR t updatet
isinstanceR t allt True( t config( ( R sA /usr/lib/python2.7/site-packages/salt/beacons/bonjour_announce.pyt validate6 s
c C@ s: t | � t | � d d k r6 | d t | � d S| S( s�
Enforces the TXT record maximum length of 255 characters.
TXT record length includes key, value, and '='.
:param str key: Key of the TXT record
:param str value: Value of the TXT record
:rtype: str
:return: The value of the TXT record. It may be truncated if it exceeds
the maximum permitted length. In case of truncation, '...' is
appended to indicate that the entire value is not present.
i i� i� s ...( t len( t keyt value( ( sA /usr/lib/python2.7/site-packages/salt/beacons/bonjour_announce.pyt _enforce_txt_record_maxlenI s c C@ s� g } i } i } i } t t | j | � � d | k rG | d } n- t d } t rt t d | k rt | | d <n t r | j d t � r t j d g � t j d g � k r� t j d g � | d <n t j d g � t j d g � k r t j d g � | d <q n xx| d D]l} d t j j j
| � } | d | j d � rN| d | d } d! } | j
d
� }
|
d k r�| d d k r�t | |
d
d !� } | |
} n t j | d � } t | t � r�| d! k r�| | } q�d j | � } n t | | � | | <t rit j | d � t j | d � k ri| | | | <qin t | | d | � | | <t s| | | | <qqW| r�t j d | � } t sn| | d <| d | d <| d | d <t j d g � | d <t j d g � | d <t j d | d | d d | d d | d t � a t j t � t j t g g g � }
t |
d k rnt j t � qnn | j d t � s�d | k r7t j � d! a | j d d � } | d k r�t j | � n t j d | d | d d | d d | d t � a t j t g g g � }
t |
d k rnt j t � qnn7 t j | � j! d � } t j" t d d! d d d | �| j# i d d 6| d 6� n | j d t � r�t j$ � a n t a | S(" s
Broadcast values via zeroconf
If the announced values are static, it is advised to set run_once: True
(do not poll) on the beacon configuration.
The following are required configuration settings:
- ``servicetype`` - The service type to announce
- ``port`` - The port of the service to announce
- ``txt`` - The TXT record of the service being announced as a dict. Grains
can be used to define TXT values using one of following two formats:
- ``grains.<grain_name>``
- ``grains.<grain_name>[i]`` where i is an integer representing the
index of the grain to use. If the grain is not a list, the index is
ignored.
The following are optional configuration settings:
- ``servicename`` - Set the name of the service. Will use the hostname from
the minion's ``host`` grain if this value is not set.
- ``reset_on_change`` - If ``True`` and there is a change in TXT records
detected, it will stop announcing the service and then restart announcing
the service. This interruption in service announcement may be desirable
if the client relies on changes in the browse records to update its cache
of TXT records. Defaults to ``False``.
- ``reset_wait`` - The number of seconds to wait after announcement stops
announcing and before it restarts announcing in the case where there is a
change in TXT records detected and ``reset_on_change`` is ``True``.
Defaults to ``0``.
- ``copy_grains`` - If ``True``, Salt will copy the grains passed into the
beacon when it backs them up to check for changes on the next iteration.
Normally, instead of copy, it would use straight value assignment. This
will allow detection of changes to grains where the grains are modified
in-place instead of completely replaced. In-place grains changes are not
currently done in the main Salt code but may be done due to a custom
plug-in. Defaults to ``False``.
Example Config
.. code-block:: yaml
beacons:
bonjour_announce:
- run_once: True
- servicetype: _demo._tcp
- port: 1234
- txt:
ProdName: grains.productname
SerialNo: grains.serialnumber
Comments: 'this is a test'
t servicenamet hostt reset_on_changet ipv4t ipv6R s txt.s grains.i t [i����t ]i t t ,t itemsR R R R t txtRecordt callBacki t
reset_waits utf-8t RecordRefR t rdatat resultt tagt changest copy_grainsN(% R R R t
__grains__t LAST_GRAINSt getR t saltt utilst stringutilst
to_unicodet
startswithR
t findt intR t joinR' R t TXTRecordt DNSServiceRegisterR R t atexitt registerR t selectt DNSServiceProcessResultR t timet sleepR t text_typet encodet DNSServiceUpdateRecordt appendt copy( R" t retR9 R R R( t itemt changes_keyt graint grain_indext square_brackett grain_valuet
txt_recordt readyR4 t txt_record_raw( ( sA /usr/lib/python2.7/site-packages/salt/beacons/bonjour_announce.pyt beacon] s� 6
$$
*
( t __doc__t
__future__R RH t loggingRJ RL t salt.utils.stringutilsR> t salt.extR t salt.ext.six.movesR R R! R t ImportErrorR t getLoggert __name__R R R< R
R R R R R# R' R] ( ( ( sA /usr/lib/python2.7/site-packages/salt/beacons/bonjour_announce.pyt <module> s.
Mini Shell