Current File : //usr/lib/python2.7/site-packages/salt/modules/system.pyo
�
���^c @@ s� d Z d d l m Z m Z m 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 m Z m Z d d l m Z d Z d � Z d � Z d
� Z d � Z d d � Z d d
� Z d � Z d � Z d � Z d � Z d � Z d � Z! d d � Z" d d � Z# d d � Z$ d d d d d d d d � Z% d d � Z& d d � Z' d e f d � � YZ( d � Z) d � Z* d � Z+ d � Z, d � Z- d! � Z. d" Z/ e d# � d$ � � Z0 e d# � d% � � Z1 d S(& u�
Support for reboot, shutdown, etc on POSIX-like systems.
.. note::
If you have configured a wrapper such as ``molly-guard`` to
intercept *interactive* shutdown commands, be aware that calling
``system.halt``, ``system.poweroff``, ``system.reboot``, and
``system.shutdown`` with ``salt-call`` will hang indefinitely
while the wrapper script waits for user input. Calling them with
``salt`` will work as expected.
i ( t absolute_importt unicode_literalst print_function( t datetimet timedeltat tzinfoN( t CommandExecutionErrort SaltInvocationError( t dependsu systemc C@ sX t j j j � r t d f St j j j � r8 t d f St j j j � rT t d f St S( uc
Only supported on POSIX-like systems
Windows, Solaris, and Mac have their own modules
u' This module is not available on Windowsu& This module is not available on Mac OSu% This module is not available on SunOS( t saltt utilst platformt
is_windowst Falset is_darwint is_sunost __virtualname__( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt __virtual__ s
c C@ s# d g } t d | d t �} | S( ui
Halt a running system
CLI Example:
.. code-block:: bash
salt '*' system.halt
u haltu cmd.runt python_shell( t __salt__R
( t cmdt ret( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt halt1 s
c C@ s/ d d j | � g } t d | d t �} | S( u�
Change the system runlevel on sysV compatible systems
CLI Example:
.. code-block:: bash
salt '*' system.init 3
u initu {0}u cmd.runR ( t formatR R
( t runlevelR R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt init@ s
c C@ s# d g } t d | d t �} | S( uq
Poweroff a running system
CLI Example:
.. code-block:: bash
salt '*' system.poweroff
u poweroffu cmd.runR ( R R
( R R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt poweroffO s
c C@ s> d d | r d j | � n d g } t d | d t �} | S( u�
Reboot the system
at_time
The wait time in minutes before the system will be rebooted.
CLI Example:
.. code-block:: bash
salt '*' system.reboot
u shutdownu -ru {0}u nowu cmd.runR ( R R R
( t at_timeR R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt reboot^ s
$c C@ s> d d | r d j | � n d g } t d | d t �} | S( u�
Shutdown a running system
at_time
The wait time in minutes before the system will be shutdown.
CLI Example:
.. code-block:: bash
salt '*' system.shutdown 5
u shutdownu -hu {0}u nowu cmd.runR ( R R R
( R R R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt shutdownp s
$c C@ s d g } | j � d k rS | | j � } | j d t d � � } | j d � n d j | j � � } | | g } t d | d t �} | d d k rd j | j � � } | | g } t d | d t �} | d d k rd
j | d � } t | � � qn t
S(
u�
set the system date/time using the date command
Note using a strictly posix-compliant date binary we can only set the date
up to the minute.
u dateR i u -uu% {1:02}{2:02}{3:02}{4:02}{0:04}.{5:02}u cmd.run_allR u retcodeu {1:02}{2:02}{3:02}{4:02}{0:04}u date failed: {0}u stderrN( t utcoffsett Nonet replacet _FixedOffsett appendR t timetupleR R
R t True( t new_dateR t non_posixt
non_posix_cmdt
ret_non_posixt posixt posix_cmdt ret_posixt msg( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt _date_bin_set_datetime� s"
c C@ s[ t j j j d g � d k rW t d d d d g d t d d d t �} | d d
k St S( u�
Returns True if the system has a hardware clock capable of being
set from software.
CLI Example:
salt '*' system.has_settable_hwclock
u hwclocku cmd.run_allu --testu --systohcR t output_loglevelu quiett ignore_retcodeu retcodei N( R R
t patht which_binR R R
R$ ( t res( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt has_settable_hwclock� s c C@ sR t d d d g d t �} | d d k rN d j | d � } t | � � n t S( u8
Set hardware clock to value of software clock.
u cmd.run_allu hwclocku --systohcR u retcodei u= hwclock failed to set hardware clock from software clock: {0}u stderr( R R
R R R$ ( R2 R, ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt _swclock_to_hwclock� s
c C@ sF d } x9 | D]1 } y t j | | � } PWq
t k
r= q
Xq
W| S( u
Attempts to parse the input time_str as a date.
:param str time_str: A string representing the time
:param list fmts: A list of date format strings.
:return: Returns a datetime object if parsed properly. Otherwise None
:rtype datetime:
N( R R t strptimet
ValueError( t time_strt fmtst resultt fmt( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt _try_parse_datetime� s
c C@ s� t j d | � } | s' t d � � n | j d � d k rB d n d } t | j d � � } t | j d � � } | | d | } | S( u�
Helper function that converts the utc offset string into number of minutes
offset. Input is in form "[+-]?HHMM". Example valid inputs are "+0500"
"-0300" and "0800". These would return -300, 180, 480 respectively.
u ^([+-])?(\d\d)(\d\d)$u Invalid UTC offseti u -i����i i i< ( t ret matchR t groupt int( t
utc_offsetR= t signt hours_offsett minutes_offsett total_offset( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt _offset_to_min� s !c C@ sb | d k rR t | � } t d | � } t j � | } | j d t | � � } n t j � } | S( uf
Will return the current time adjusted using the input timezone offset.
:rtype datetime:
t minutesR N( R RE R R t utcnowR R! t now( R@ RF t offsett offset_time( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt _get_offset_time� s c C@ s t | � } t j | d � S( u
Get the system time.
:param str utc_offset: The utc offset in 4 digit (+0600) format with an
optional sign (+/-). Will default to None which will use the local
timezone. To set the time based off of UTC use "'+0000'". Note: if
being passed through the command line will need to be quoted twice to
allow negative offsets.
:return: Returns the system time in HH:MM:SS AM/PM format.
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' system.get_system_time
u %I:%M:%S %p( RK R t strftime( R@ RJ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt get_system_time� s c C@ sY d d d d g } t | | � } | d k r1 t St d | j d | j d | j d | � S(
u�
Set the system time.
:param str newtime:
The time to set. Can be any of the following formats.
- HH:MM:SS AM/PM
- HH:MM AM/PM
- HH:MM:SS (24 hour)
- HH:MM (24 hour)
Note that the salt command line parser parses the date/time
before we obtain the argument (preventing us from doing utc)
Therefore the argument must be passed in as a string.
Meaning you may have to quote the text twice from the command line.
:param str utc_offset: The utc offset in 4 digit (+0600) format with an
optional sign (+/-). Will default to None which will use the local
timezone. To set the time based off of UTC use "'+0000'". Note: if
being passed through the command line will need to be quoted twice to
allow negative offsets.
:return: Returns True if successful. Otherwise False.
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' system.set_system_time "'11:20'"
u %I:%M:%S %pu %I:%M %pu %H:%M:%Su %H:%Mt hoursRF t secondsR@ N( R; R R
t set_system_date_timet hourt minutet second( t newtimeR@ R8 t dt_obj( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt set_system_time s c C@ s t | � } t j | d � S( u-
Get the system date/time.
:param str utc_offset: The utc offset in 4 digit (+0600) format with an
optional sign (+/-). Will default to None which will use the local
timezone. To set the time based off of UTC use "'+0000'". Note: if
being passed through the command line will need to be quoted twice to
allow negative offsets.
:return: Returns the system time in YYYY-MM-DD hh:mm:ss format.
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' system.get_system_date_time "'-0500'"
u %Y-%m-%d %H:%M:%S( RK R RL ( R@ RJ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt get_system_date_time; s c
C@ s
t | � } | d k r$ | j } n | d k r< | j } n | d k rT | j } n | d k rl | j } n | d k r� | j } n | d k r� | j } n y( t | | | | | | d | j � } Wn" t
k
r� } t | j � � n Xt
| � s� t St � r t � St S( u�
Set the system date and time. Each argument is an element of the date, but
not required. If an element is not passed, the current system value for
that element will be used. For example, if you don't pass the year, the
current system year will be used. (Used by set_system_date and
set_system_time)
Updates hardware clock, if present, in addition to software
(kernel) clock.
:param int years: Years digit, ie: 2015
:param int months: Months digit: 1 - 12
:param int days: Days digit: 1 - 31
:param int hours: Hours digit: 0 - 23
:param int minutes: Minutes digit: 0 - 59
:param int seconds: Seconds digit: 0 - 59
:param str utc_offset: The utc offset in 4 digit (+0600) format with an
optional sign (+/-). Will default to None which will use the local
timezone. To set the time based off of UTC use "'+0000'". Note: if
being passed through the command line will need to be quoted twice to
allow negative offsets.
:return: True if successful. Otherwise False.
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' system.set_system_date_time 2015 5 12 11 37 53 "'-0500'"
i N( RK R t yeart montht dayRQ RR RS R R R6 R t messageR- R
R3 R4 R$ (
t yearst monthst daysRN RF RO R@ t date_timet new_datetimet err( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyRP Q s. & c C@ s t | � } t j | d � S( u�
Get the system date
:param str utc_offset: The utc offset in 4 digit (+0600) format with an
optional sign (+/-). Will default to None which will use the local
timezone. To set the time based off of UTC use "'+0000'". Note: if
being passed through the command line will need to be quoted twice to
allow negative offsets.
:return: Returns the system date.
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' system.get_system_date
u %a %m/%d/%Y( RK R RL ( R@ RJ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt get_system_date� s c C@ sj d d d d d d g } t | | � } | d k rB t d � � n t d | j d | j d
| j d | � S(
ut
Set the system date. Use <mm-dd-yy> format for the date.
:param str newdate:
The date to set. Can be any of the following formats:
- YYYY-MM-DD
- MM-DD-YYYY
- MM-DD-YY
- MM/DD/YYYY
- MM/DD/YY
- YYYY/MM/DD
CLI Example:
.. code-block:: bash
salt '*' system.set_system_date '03-28-13'
u %Y-%m-%du %m-%d-%Yu %m-%d-%yu %m/%d/%Yu %m/%d/%yu %Y/%m/%du Invalid date formatR\ R] R^ R@ N( R; R R RP RX RY RZ ( t newdateR@ R8 RU ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt set_system_date� s R! c B@ s2 e Z d Z d � Z d � Z d � Z d � Z RS( u0
Fixed offset in minutes east from UTC.
c C@ s, t | j | � j � t d | � | _ d S( NRF ( t supert __class__t __init__R t _FixedOffset__offset( t selfRI ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyRg � s c C@ s | j S( N( Rh ( Ri t dt( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyR � s c C@ s d S( N( R ( Ri Rj ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt tzname� s c C@ s
t d � S( Ni ( R ( Ri Rj ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt dst� s ( t __name__t
__module__t __doc__Rg R Rk Rl ( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyR! � s
c C@ s2 | d | d k r. | j d � r. | d d !S| S( uA
Helper function to strip off the ' or " off of a string
i i����u 'u "i ( u 'u "( t
startswith( t str_q( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt
_strip_quotes� s # c C@ s" t j j j d � } | r= t d | d d g d t �} n� d
} t j d � } y� t j j j
d d � �f } x\ | j � D]N } t j j j
| � } | j | � } | r} t | j d � j � � } q} q} WWd
QXWn t k
r� n X| d
k r� t S| j d d � j d
d � j d d � S( u:
Get PRETTY_HOSTNAME value stored in /etc/machine-info
If this file doesn't exist or the variable doesn't exist
return False.
:return: Value of PRETTY_HOSTNAME if this does not exist False.
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' system.get_computer_desc
u hostnamectlu cmd.runu statusu --prettyR u ^\s*PRETTY_HOSTNAME=(.*)$u /etc/machine-infou ri Nu \"u "u \nu
u \tu ( R R
R0 t whichR R
R R< t compilet filest fopent readlinest stringutilst
to_unicodeR= Rr R> t stript IOErrorR ( t hostname_cmdt desct patternt mach_infot lineR= ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt get_computer_desc� s& ,
c C@ s� t j j j | � j d d � j d d � j d d � } t j j j d � } | r� t d | d d
| g d t �} | d k r� t St St
j j d
� s� t j j j
d
d � � Wd QXn t j d � } t j j j d j | � � } y� t j j j
d
d � �� } | j � } xS t | � D]8 \ } } | j t j j j | � � r"| | | <Pq"q"W| j | � | j d d � | j � | j | � t SWd QXWn t k
r�t SXd S( u�
Set PRETTY_HOSTNAME value stored in /etc/machine-info
This will create the file if it does not exist. If
it is unable to create or modify this file returns False.
:param str desc: The computer description
:return: False on failure. True if successful.
CLI Example:
.. code-block:: bash
salt '*' system.set_computer_desc "Michael's laptop"
u "u \"u
u \nu u \tu hostnamectlu cmd.retcodeu set-hostnameu --prettyR i u /etc/machine-infou wNu ^\s*PRETTY_HOSTNAME=(.*)$u PRETTY_HOSTNAME="{0}"u r+( R R
Rx Ry R R0 Rs R R
R$ t ost isfileRu Rv R< Rt t to_strR Rw t enumerateR= R" t seekt truncatet
writelinesR{ ( R} R| R9 R~ t new_lineR t linest iR� ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt set_computer_desc s6 -
c C@ s t d | � S( u�
Modify hostname.
CLI Example:
.. code-block:: bash
salt '*' system.set_computer_name master.saltstack.com
u network.mod_hostname( R ( t hostname( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt set_computer_nameM s
c C@ s t d � S( uj
Get hostname.
CLI Example:
.. code-block:: bash
salt '*' network.get_hostname
u network.get_hostname( R ( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt get_computer_nameZ s
c C@ s t j d � d k S( u@
Determine whether the minion is running on NI Linux RT
u os_familyu NILinuxRT( t
__grains__t get( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt _is_nilrt_familyg s u' /var/volatile/tmp/salt/reboot_witnessedu _is_nilrt_familyc C@ s� d } t j j t � } t j j | � s� y t j | � Wn4 t k
rq } t d j | | j | j
� � � n Xt d d j t � � } | d } n | d k S( ud
This function is used to remember that an event indicating that a reboot is
required was witnessed. This function writes to a temporary filesystem so
the event gets cleared upon reboot.
Returns:
bool: ``True`` if successful, otherwise ``False``
.. code-block:: bash
salt '*' system.set_reboot_required_witnessed
i����u Error creating {0} (-{1}): {2}u cmd.run_allu touch {0}u retcodei ( R� R0 t dirnamet NILRT_REBOOT_WITNESS_PATHt existst makedirst OSErrorR R t errnot strerrorR ( t errcodet dir_patht ext rdict( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt set_reboot_required_witnessedq s
c C@ s t j j t � S( uR
Determine if at any time during the current boot session the salt minion
witnessed an event indicating that a reboot is required.
Returns:
bool: ``True`` if the a reboot request was witnessed, ``False`` otherwise
CLI Example:
.. code-block:: bash
salt '*' system.get_reboot_required_witnessed
( R� R0 R� R� ( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt get_reboot_required_witnessed� s (2 Ro t
__future__R R R R R R R< t os.pathR� t salt.utils.filesR t salt.utils.patht salt.utils.platformt salt.exceptionsR R t salt.utils.decoratorsR R R R R R R R R R- R3 R4 R; RE RK RM RV RW RP Rb Rd R! Rr R� R� R� R� R� R� R� R� ( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/system.pyt <module> sX * ' A & * 3
Mini Shell