Current File : //lib/python2.7/site-packages/salt/modules/systemd_service.pyo
�
���^c @@ s� d Z d d l m Z m Z 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
Z
d d l 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 e j e � Z i d d 6d d 6Z d? Z d Z d
Z d@ Z d Z d � Z d � Z d � Z! d � Z" d � Z# d � Z$ d � Z% d � Z& d d � Z( d � Z) d! � Z* d" � Z+ d e, e, d# � Z- d$ � Z. d% � Z/ d& � Z0 d' � Z1 d( � Z2 d) � Z3 d* � Z4 d+ � Z5 d, � Z6 d- � Z7 d. � Z8 d/ � Z9 e, d0 � Z: e, d1 � Z; e, d2 � Z< e, e, e, d3 � Z= e, d4 � Z> e, e, e, d5 � Z? e, e, e, d6 � Z@ eA e, e, d7 � ZB d d8 � ZC e, e, e, d9 � ZD e, d: � ZE d; � ZF d< � ZG d= � ZH d> � ZI d S(A uG
Provides the service module for systemd
.. versionadded:: 0.10.0
.. important::
If you feel that Salt should be using this module to manage services on a
minion, and it is using a different module (or gives an error similar to
*'service.start' is not available*), see :ref:`here
<module-provider-override>`.
i ( t absolute_importt print_functiont unicode_literalsN( t CommandExecutionError( t sixu reloadu reload_u unmasku unmask_u /lib/systemd/systemu /usr/lib/systemd/systemu /etc/systemd/systemu /etc/init.du serviceu socketu deviceu mountu automountu swapu targetu pathu timerc C@ s3 t d d k r) t j j j t � r) t St d f S( uA
Only work on systems that have been booted with systemd
u kernelu Linuxuq The systemd execution module failed to load: only available on Linux systems which have been booted with systemd.( t
__grains__t saltt utilst systemdt bootedt __context__t __virtualname__t False( ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt __virtual__6 s
c @ sL t � t j � s$ t j � � � n t � f d � t D� � rD � Sd � S( um
Build a canonical unit name treating unit names without one
of the valid suffixes as a service.
c 3@ s | ] } � j | � Vq d S( N( t endswith( t .0t suffix( t name( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pys <genexpr>K s u
%s.service( t
isinstanceR t string_typest text_typet anyt VALID_UNIT_TYPES( R ( ( R s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _canonical_unit_nameD s
c C@ s� t | � } t j j j t � } | d k rU | d k rU d | d k oR d k SS| d j � } d | k ru t Sxa t j j j
| d � D]7 } t j d | � } | r� | j
d � d
k } Pq� q� Wt d | � � | S(
uO
Returns boolean telling whether or not the named service is available
i� i u retcodei u stdoutu could not be foundu
u \s+loaded:\s+(\S+)i u not-foundu& Failed to get information on unit '%s'N( t _systemctl_statusR R R t versionR
t Nonet lowerR t itertoolst splitt ret matcht groupR ( R t _statust
sd_versiont outt lineR t ret( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _check_availableP s
c C@ sN d j | � } | t k rJ t | � s3 t | � r= t � n t t | <n d S( u^
Check for modified/updated unit files, and run a daemon-reload if any are
found.
u# systemd._check_for_unit_changes.{0}N( t formatR
t _untracked_custom_unit_foundt _unit_file_changedt systemctl_reloadt True( R t
contextkey( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _check_for_unit_changesq s
c C@ s6 | r t | d t �n | r2 t | d t �n d S( uf
Common code for conditionally removing masks before making changes to a
service's state.
t runtimeN( t unmask_R R+ ( R t unmaskt unmask_runtime( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt
_check_unmask~ s c C@ sU xN t t � D]@ } y# | j d � r5 t j | � n Wq
t k
rL q
q
Xq
Wd S( u
Remove context
u systemd._systemctl_status.N( t listR
t
startswitht popt AttributeError( t key( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _clear_context� s
c C@ s� ys t j j j d � �X } xN | D]F } t j j j | � } | j d � r" | j d � d j � } q" q" WWd QXWn t k
r� d SXyz t j j j d � �_ } xU | D]M } t j j j | � } | j d � r� d | k r� | j d
� d } q� q� WWd QXWn t k
rn Xy� t
d � } t j j j d � �` } xV | D]N } t j j j | � } x0 | j � j � D] } | | k rr| } PqrqrWqDWWd QXWn t k
r�n X| S( u�
Try to figure out the default runlevel. It is kept in
/etc/init/rc-sysinit.conf, but can be overridden with entries
in /etc/inittab, or via the kernel command-line at boot
u /etc/init/rc-sysinit.confu env DEFAULT_RUNLEVELu =i����Nu 2u /etc/inittabu #u initdefaultu :i u 0u 1u 3u 4u 5u 6u su Su -su singleu
/proc/cmdline( u 0u 1u 2u 3u 4u 5u 6u su Su -su single( R R t filest fopent stringutilst
to_unicodeR4 R t stript Exceptiont set( t fp_R$ t runlevelt
valid_stringst arg( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _default_runlevel� s:
*
$
c C@ s� t � } x� t t f D]� } t j | t j � r t j j | � r x{ t j | � D]g } y | j d d � \ } } Wn t
k
r� qU n X| t k rU | j | d k r� | n | � qU qU Wq q W| S( u4
Use os.listdir() to get all the unit files
u .i u service(
R? t SYSTEM_CONFIG_PATHSt LOCAL_CONFIG_PATHt ost accesst R_OKt patht islinkt listdirt rsplitt
ValueErrorR t add( R% RJ t fullnamet unit_namet unit_type( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _get_systemd_services� s (
-c C@ s y t j t � } Wng t k
r| } | j t j k r: n> | j t j k r_ t j d t � n t j d | j | j � g SX| d k r� t � } n g } xg | D]_ } t j t j
j t | � t j � r� | | k r� t j d | | � q� n | j | � q� q� W| S( uE
Use os.listdir() and os.access() to get all the initscripts
u9 Unable to check sysvinit scripts, permission denied to %su9 Error %d encountered trying to check sysvinit scripts: %suH sysvinit script '%s' found, but systemd unit '%s.service' already existsN( RG RL t INITSCRIPT_PATHt OSErrort errnot ENOENTt EACCESt logt errort strerrorR RS RH RJ t joint X_OKt debugt append( t systemd_servicest
sysv_servicest excR% t sysv_service( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _get_sysv_services� s4
$
c C@ s� d } | t k ry d } xQ | D]+ } t j j j | � } | d k r Pq q Wt d j d j | � � � � | t | <n t | S( u\
Returns the path to the sysv service manager (either update-rc.d or
chkconfig)
u systemd._get_service_execu update-rc.du chkconfigu/ Unable to find sysv service manager (tried {0})u , ( u update-rc.du chkconfigN( R
R R RJ t whichR R R' R\ ( R, t executablest
executablet service_exec( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _get_service_exec� s
c C@ su d } | t k r t | St d d d t d t �} y | j � d } Wn t k
rf t � } n X| t | <| S( u%
Return the current runlevel
u systemd._runlevelu cmd.runu runlevelt python_shellt ignore_retcodei ( R
t __salt__R R+ R t
IndexErrorRD ( R, R# R% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _runlevel s
c C@ sO g } x3 | j � D]% } | j d � s | j | � q q Wd j | � j � S( u�
Strip unnecessary message about running the command with --scope from
stderr so that we can raise an exception with the remaining stderr text.
u .scopeu
( t
splitlinesR R_ R\ R= ( t msgR% R$ ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _strip_scope& s
c C@ s� g } | rJ t j j j t � rJ t d d t � rJ | j d d g � n | j d � | rm | j d � n t | t
j � r� t j
| � } n | j | � | d
k r� | j t | � � n d | k r� | j d d g � n | S( un
Build a systemctl command line. Treat unit names without one
of the valid suffixes as a service.
u
config.getu
systemd.scopeu systemd-runu --scopeu systemctlu
--no-blocku statusu -nu 0N( R R R t has_scopeR
Rl R+ t extendR_ R R R t shlexR R R ( t actionR t
systemd_scopet no_blockR% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt _systemctl_cmd2 s
c C@ sU d | } | t k r t | St d t d | � d t d t d t �t | <t | S( uq
Helper function which leverages __context__ to keep from running 'systemctl
status' more than once.
u systemd._systemctl_status.%su cmd.run_allu statusRj t redirect_stderrRk ( R
Rl Rx R R+ ( R R, ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyR I s
c C@ sQ xJ t j d t � | f � D], } t j d | t j j | � � r t Sq Wt S( u�
A System-V style service is assumed disabled if the "startup" symlink
(starts with "S") to its script is found in /etc/init.d in the current
runlevel.
u /etc/rc%s.d/S*%su S\d{,2}%s( t globRn R R RG RJ t basenameR+ R ( R R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt
_sysv_enabledZ s #"c C@ s; t j j d t | � � } t j | t j � o: t | � S( u�
If the passed service name is not available, but a unit file exist in
/etc/systemd/system, return True. Otherwise, return False.
u /etc/systemd/system( RG RJ R\ R RH RI R& ( R t unit_path( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyR( g s c C@ s d t | � d j � k S( uh
Returns True if systemctl reports that the unit file has changed, otherwise
returns False.
u 'systemctl daemon-reload'u stdout( R R ( R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyR) q s c C@ sT t d t d � d t d t �} | d d k rI t d | d � � n t � t S( u�
.. versionadded:: 0.15.0
Reloads systemctl, an action needed whenever unit files are updated.
CLI Example:
.. code-block:: bash
salt '*' service.systemctl_reload
u cmd.run_allu --system daemon-reloadRj Ry u retcodei u. Problem performing systemctl daemon-reload: %su stdout( Rl Rx R R+ R R8 ( R# ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyR* y s c C@ s0 t � } t d t d � d t d t �} x� t j j j | d � D]� } y? | j � j � } | d } t
| � d k r� | d } n Wn# t k
r� } t j
| � qD n X| d k r� qD n y | j d d
� \ } } Wn t k
r� qD n X| t k rD | j | d k r| n | � qD qD Wt | � S( u�
Return a list of all running services, so far as systemd is concerned
CLI Example:
.. code-block:: bash
salt '*' service.get_running
u cmd.runu --full --no-legend --no-pagerRj Rk u
i i u runningu .i u service( R? Rl Rx R R+ R R R R R= t lenRN RY RZ RM R RO t sorted( R% R# R$ t compsRP t active_stateRb RQ RR ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt get_running� s.
&c C@ s9 t � } t d t d � d t d t �} x� t j j j | d � D]� } y" | j � j d
d � \ } } Wn t k
r� qD n X| d k r� qD n y | j d d � \ } } Wn t k
r� qD n X| t
k rD | j | d k r� | n | � qD qD W| j t g t � D] } t | � r
| ^ q
� � t | � S( u�
Return a list of all enabled services
CLI Example:
.. code-block:: bash
salt '*' service.get_enabled
u cmd.runu- --full --no-legend --no-pager list-unit-filesRj Rk u
i u enabledu .u serviceN( R? Rl Rx R R+ R R R R R= R RN RM R RO t updateRd R| R ( R% R# R$ RP t
unit_stateRQ RR t x( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt get_enabled� s*
"
& ,c C@ s9 t � } t d t d � d t d t �} x� t j j j | d � D]� } y" | j � j d
d � \ } } Wn t k
r� qD n X| d k r� qD n y | j d d � \ } } Wn t k
r� qD n X| t
k rD | j | d k r� | n | � qD qD W| j t g t � D] } t | � s
| ^ q
� � t | � S( u�
Return a list of all disabled services
CLI Example:
.. code-block:: bash
salt '*' service.get_disabled
u cmd.runu- --full --no-legend --no-pager list-unit-filesRj Rk u
i u disabledu .u serviceN( R? Rl Rx R R+ R R R R R= R RN RM R RO R� Rd R| R ( R% R# R$ RP R� RQ RR R� ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt get_disabled� s*
"
& ,c C@ s t � } t d t d � d t d t �} x� t j j j | d � D]� } y" | j � j d
d � \ } } Wn t k
r� qD n X| d k r� qD n y | j d d � \ } } Wn t k
r� qD n X| t
k rD | j | d k r� | n | � qD qD Wt | � S( u�
.. versionadded:: 2015.8.5
Return a list of all static services
CLI Example:
.. code-block:: bash
salt '*' service.get_static
u cmd.runu- --full --no-legend --no-pager list-unit-filesRj Rk u
i u staticu .u serviceN( R? Rl Rx R R+ R R R R R= R RN RM R RO R ( R% R# R$ RP R� RQ RR ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt
get_static s& "
&c C@ s/ t � } | j t t d | � � � t | � S( u
Return a list of all available services
CLI Example:
.. code-block:: bash
salt '*' service.get_all
R` ( RS R� R? Rd R ( R% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt get_all0 s
c C@ s t | � t | � S( u�
.. versionadded:: 0.10.4
Check that the given service is available taking into account template
units.
CLI Example:
.. code-block:: bash
salt '*' service.available sshd
( R- R& ( R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt available? s
c C@ s t | � S( u+
.. versionadded:: 2014.1.0
The inverse of :py:func:`service.available
<salt.modules.systemd.available>`. Returns ``True`` if the specified
service is not available, otherwise returns ``False``.
CLI Example:
.. code-block:: bash
salt '*' service.missing sshd
( R� ( R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt missingP s c C@ s� t | � t | | � s< t j d | | r1 d n d � t S| rH d n d } t d t | | d t �d t d t �} | d
d k r� t d | � � n t S(
u�
.. versionadded:: 2015.5.0
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
Unmask the specified service with systemd
runtime : False
Set to ``True`` to unmask this service only until the next reboot
.. versionadded:: 2017.7.0
In previous versions, this function would remove whichever mask was
identified by running ``systemctl is-enabled`` on the service.
However, since it is possible to both have both indefinite and
runtime masks on a service simultaneously, this function now
removes a runtime mask only when this argument is set to ``True``,
and otherwise removes an indefinite mask.
CLI Example:
.. code-block:: bash
salt '*' service.unmask foo
salt '*' service.unmask foo runtime=True
u Service '%s' is not %smaskedu runtime-u u unmask --runtimeu unmasku cmd.run_allRv Rj Ry u retcodei u Failed to unmask service '%s'( R- t maskedRY R^ R+ Rl Rx R R ( R R. t cmdR# ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyR/ a s "
c C@ sx t | � | r d n d } t d t | | d t �d t d t �} | d d k rt t d | d
| d �� n t S( u�
.. versionadded:: 2015.5.0
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
Mask the specified service with systemd
runtime : False
Set to ``True`` to mask this service only until the next reboot
.. versionadded:: 2015.8.5
CLI Example:
.. code-block:: bash
salt '*' service.mask foo
salt '*' service.mask foo runtime=True
u mask --runtimeu masku cmd.run_allRv Rj Ry u retcodei u Failed to mask service '%s't infou stdout( R- Rl Rx R+ R R ( R R. R� R# ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt mask� s
c C@ s� t | � | r d n d } t j j | d d t | � � } y t j | � d k SWnd t k
r� } | j t j k r� t j
d | | � n( | j t j k r� t j d | | � n t
SXd S( u:
.. versionadded:: 2015.8.0
.. versionchanged:: 2015.8.5
The return data for this function has changed. If the service is
masked, the return value will now be the output of the ``systemctl
is-enabled`` command (so that a persistent mask can be distinguished
from a runtime mask). If the service is not masked, then ``False`` will
be returned.
.. versionchanged:: 2017.7.0
This function now returns a boolean telling the user whether a mask
specified by the new ``runtime`` argument is set. If ``runtime`` is
``False``, this function will return ``True`` if an indefinite mask is
set for the named service (otherwise ``False`` will be returned). If
``runtime`` is ``False``, this function will return ``True`` if a
runtime mask is set, otherwise ``False``.
Check whether or not a service is masked
runtime : False
Set to ``True`` to check for a runtime mask
.. versionadded:: 2017.7.0
In previous versions, this function would simply return the output
of ``systemctl is-enabled`` when the service was found to be
masked. However, since it is possible to both have both indefinite
and runtime masks on a service simultaneously, this function now
only checks for runtime masks if this argument is set to ``True``.
Otherwise, it will check for an indefinite mask.
CLI Examples:
.. code-block:: bash
salt '*' service.masked foo
salt '*' service.masked foo runtime=True
u /runu /etcu systemdu systemu /dev/nulluW Path %s does not exist. This is normal if service '%s' is not masked or does not exist.u� Failed to check mask status for service %s. Path %s is a file, not a symlink. This could be caused by changes in systemd and is probably a bug in Salt. Please report this to the developers.N( R- RG RJ R\ R t readlinkRU RV RW RY t tracet EINVALRZ R ( R R. t root_dirt link_pathRb ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyR� � s$ %
c C@ sr t | � t | | | � t d t d | d t d | �d t �} | d d k rn t t | d � � � n t S( u�
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
Start the specified service with systemd
no_block : False
Set to ``True`` to start the service using ``--no-block``.
.. versionadded:: 2017.7.0
unmask : False
Set to ``True`` to remove an indefinite mask before attempting to start
the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
starting. This behavior is no longer the default.
unmask_runtime : False
Set to ``True`` to remove a runtime mask before attempting to start the
service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
starting. This behavior is no longer the default.
CLI Example:
.. code-block:: bash
salt '*' service.start <service name>
u cmd.run_allu startRv Rw Rj u retcodei u stderr( R- R2 Rl Rx R+ R R Rq ( R Rw R0 R1 R% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt start� s *
c C@ s= t | � t d t d | d t d | �d t �d d k S( u�
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
Stop the specified service with systemd
no_block : False
Set to ``True`` to start the service using ``--no-block``.
.. versionadded:: 2017.7.0
CLI Example:
.. code-block:: bash
salt '*' service.stop <service name>
u cmd.run_allu stopRv Rw Rj u retcodei ( R- Rl Rx R+ R ( R Rw ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt stop5 s
c C@ sr t | � t | | | � t d t d | d t d | �d t �} | d d k rn t t | d � � � n t S( u
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
Restart the specified service with systemd
no_block : False
Set to ``True`` to start the service using ``--no-block``.
.. versionadded:: 2017.7.0
unmask : False
Set to ``True`` to remove an indefinite mask before attempting to
restart the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
restarting. This behavior is no longer the default.
unmask_runtime : False
Set to ``True`` to remove a runtime mask before attempting to restart
the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
restarting. This behavior is no longer the default.
CLI Example:
.. code-block:: bash
salt '*' service.restart <service name>
u cmd.run_allu restartRv Rw Rj u retcodei u stderr( R- R2 Rl Rx R+ R R Rq ( R Rw R0 R1 R% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt restartV s *
c C@ sr t | � t | | | � t d t d | d t d | �d t �} | d d k rn t t | d � � � n t S( u�
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
Reload the specified service with systemd
no_block : False
Set to ``True`` to reload the service using ``--no-block``.
.. versionadded:: 2017.7.0
unmask : False
Set to ``True`` to remove an indefinite mask before attempting to
reload the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
reloading. This behavior is no longer the default.
unmask_runtime : False
Set to ``True`` to remove a runtime mask before attempting to reload
the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
reloading. This behavior is no longer the default.
CLI Example:
.. code-block:: bash
salt '*' service.reload <service name>
u cmd.run_allu reloadRv Rw Rj u retcodei u stderr( R- R2 Rl Rx R+ R R Rq ( R Rw R0 R1 R% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt reload_� s *
c C@ sr t | � t | | | � t d t d | d t d | �d t �} | d d k rn t t | d � � � n t S( u@
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
.. versionadded:: 0.12.0
Force-reload the specified service with systemd
no_block : False
Set to ``True`` to start the service using ``--no-block``.
.. versionadded:: 2017.7.0
unmask : False
Set to ``True`` to remove an indefinite mask before attempting to
force-reload the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
force-reloading. This behavior is no longer the default.
unmask_runtime : False
Set to ``True`` to remove a runtime mask before attempting to
force-reload the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
force-reloading. This behavior is no longer the default.
CLI Example:
.. code-block:: bash
salt '*' service.force_reload <service name>
u cmd.run_allu force-reloadRv Rw Rj u retcodei u stderr( R- R2 Rl Rx R+ R R Rq ( R Rw R0 R1 R% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt force_reload� s ,
c C@ s� t t j d | � � } | r6 t j t � | � } n | g } i } xG | D]? } t | � t d t d | � d t d t
�d k | | <qL W| r� | S| | S( uM
Return the status for a service via systemd.
If the name contains globbing, a dict mapping service name to True/False
values is returned.
.. versionchanged:: 2018.3.0
The service name can now be a glob (e.g. ``salt*``)
Args:
name (str): The name of the service to check
sig (str): Not implemented
Returns:
bool: True if running, False otherwise
dict: Maps service name to True if running, False otherwise
CLI Example:
.. code-block:: bash
salt '*' service.status <service name> [service signature]
u \*|\?|\[.+\]u cmd.retcodeu is-activeRj Rk i ( t boolR t searcht fnmatcht filterR� R- Rl Rx R R+ ( R t sigt contains_globbingt servicest resultst service( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt status s
c K@ sJ t | � t | | | � | t � k r� g } t j j j t � rm t d d t � rm | j
d d g � n t � } | j d � r� | j
| d | d d g � n( | j d � r� | j
| | d
g � n t d | d t
d
t �d k St d t d | d t d | �d t
d
t �} | d d k rFt t | d � � � n t S( u
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
Enable the named service to start when the system boots
no_block : False
Set to ``True`` to start the service using ``--no-block``.
.. versionadded:: 2017.7.0
unmask : False
Set to ``True`` to remove an indefinite mask before attempting to
enable the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
enabling. This behavior is no longer the default.
unmask_runtime : False
Set to ``True`` to remove a runtime mask before attempting to enable
the service.
.. versionadded:: 2017.7.0
In previous releases, Salt would simply unmask a service before
enabling. This behavior is no longer the default.
CLI Example:
.. code-block:: bash
salt '*' service.enable <service name>
u
config.getu
systemd.scopeu systemd-runu --scopeu /update-rc.du -fu defaultsu 99u
/chkconfigu onu cmd.retcodeRj Rk i u cmd.run_allu enableRv Rw u retcodeu stderr( R- R2 Rd R R R Rr R
Rl R+ Rs Ri R R Rx R Rq ( R Rw R0 R1 t kwargsR� Rh R% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt enable, s, *
c K@ s t | � | t � k r� g } t j j j t � r] t d d t � r] | j d d g � n t
� } | j d � r� | j | d | d g � n( | j d � r� | j | | d g � n t d
| d t d t �d
k St d t
d | d t d | �d t d t �d d
k S( u�
.. versionchanged:: 2015.8.12,2016.3.3,2016.11.0
On minions running systemd>=205, `systemd-run(1)`_ is now used to
isolate commands run by this function from the ``salt-minion`` daemon's
control group. This is done to avoid a race condition in cases where
the ``salt-minion`` service is restarted while a service is being
modified. If desired, usage of `systemd-run(1)`_ can be suppressed by
setting a :mod:`config option <salt.modules.config.get>` called
``systemd.scope``, with a value of ``False`` (no quotes).
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
Disable the named service to not start when the system boots
no_block : False
Set to ``True`` to start the service using ``--no-block``.
.. versionadded:: 2017.7.0
CLI Example:
.. code-block:: bash
salt '*' service.disable <service name>
u
config.getu
systemd.scopeu systemd-runu --scopeu /update-rc.du -fu removeu
/chkconfigu offu cmd.retcodeRj Rk i u cmd.run_allu disableRv Rw u retcode( R- Rd R R R Rr R
Rl R+ Rs Ri R R Rx ( R Rw R� R� Rh ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt disablet s$
c K@ s� t d t d | � d t d t �d k r/ t Sd | k r| d t d | d d
d d g } t t d
| d t �� r� t Sn | t � k r� t | � St S( u�
Return if the named service is enabled to start on boot
CLI Example:
.. code-block:: bash
salt '*' service.enabled <service name>
u cmd.retcodeu
is-enabledRj Rk i u @u findu -nameu -typeu lu -printu -quitu cmd.run( Rl Rx R R+ RF R� Rd R| ( R R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt enabled� s
c C@ s t | � S( u�
Return if the named service is disabled from starting on boot
CLI Example:
.. code-block:: bash
salt '*' service.disabled <service name>
( R� ( R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt disabled� s
c C@ s& i } t d t d | � d t �} x� t j j j | d � D]� } | j d � } | d } d j | d � } | j d � r� | j d d � j d
d � } i | | <xt | j d � D]7 } | j d � } | d j
� | | | d j
� <q� Wq> | d k r| j � | | <q> | | | <q> W| S( u�
.. versionadded:: 2014.7.0
Show properties of one or more units/jobs or the manager
CLI Example:
salt '*' service.show <service name>
u cmd.runu showRj u
u =i i u {u u }u ; u Beforeu Afteru Wants( u Beforeu Afteru Wants( Rl Rx R R R R R R\ R4 t replaceR= ( R R% R# R$ R� t valuet item( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt show� s"
) c C@ sN i } xA t � D]6 } t | � } d | k r4 q n | d d | | <q W| S( u�
.. versionadded:: 2014.7.0
Return a list of all files specified as ``ExecStart`` for all services.
CLI Example:
salt '*' service.execs
u ExecStartu path( R� R� ( R% R� t data( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt execs� s
( u /lib/systemd/systemu /usr/lib/systemd/system( u serviceu socketu deviceu mountu automountu swapu targetu pathu timer(J t __doc__t
__future__R R R RV Rz t loggingRG R� R Rt t salt.utils.filesR t salt.utils.itertoolst salt.utils.patht salt.utils.stringutilst salt.utils.systemdt salt.exceptionsR t salt.extR t getLoggert __name__RY t __func_alias__RE RF RT R R R
R R& R- R2 R8 RD RS R Rd Ri Rn Rq R Rx R R| R( R) R* R� R� R� R� R� R� R� R/ R� R� R� R� R� R� R+ R� R� R� R� R� R� R� R� ( ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/systemd_service.pyt <module> s�
!
- '
' ( ( ' 3 , =8 !88= )H 1 !
Mini Shell