Current File : //usr/lib/python2.7/site-packages/salt/modules/useradd.pyo
�
���^c @@ s8 d Z d d l m Z m Z m Z y d d l Z e Z Wn e k
rQ e Z n Xd 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 d Z d � Z d � Z d � Z d
� Z d d � Z d d d d d e e d d d d d e d d e d
� Z e e d d � Z! e d � Z" d � Z# d d � Z$ d d � Z% e d d � Z& e d d � Z' d � Z( d � Z) d � Z* d � Z+ d � Z, d d � Z- d � Z. d � Z/ d � Z0 e
j1 j2 j3 j4 d � d � � Z5 d � Z6 d! � Z7 d d" � Z8 d S(# u$
Manage users with the useradd command
.. important::
If you feel that Salt should be using this module to manage users on a
minion, and it is using a different module (or gives an error similar to
*'user.info' is not available*), see :ref:`here
<module-provider-override>`.
i ( t absolute_importt print_functiont unicode_literalsN( t CommandExecutionError( t sixu userc C@ s$ t r t d d k r t St d f S( uL
Set the user module if the kernel is Linux, OpenBSD, NetBSD or AIX
u kernelu Linuxu OpenBSDu NetBSDu AIXu useradd execution module not loaded: either pwd python library not available or system not one of Linux, OpenBSD, NetBSD or AIX( u Linuxu OpenBSDu NetBSDu AIX( t HAS_PWDt
__grains__t __virtualname__t False( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt __virtual__& s c C@ s3 t | t j � s t | � St j j j | � Sd S( uS
Usernames can only contain ascii chars, so make sure we return a str type
N( t
isinstanceR t string_typest strt saltt utilst stringutilst to_str( t name( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt _quote_username0 s
c C@ s� t j j j t j t | � � j � j d d � } | s= i Sx# t | � d k rb | j
d � q@ Wi t j j j | d � d 6t j j j | d � d 6t j j j | d � d
6t j j j | d � d 6t j j j | d � d
6Sd S( uD
Retrieve GECOS field info and return it in dictionary form
u ,i i u i u fullnamei u
roomnumberi u workphonei u homephoneu otherN(
R
R R t
to_unicodet pwdt getpwnamR t pw_gecost splitt lent appendt datat decode( R t gecos_field( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt
_get_gecos: s ' c C@ s^ d j | j d d � | j d d � | j d d � | j d d � | j d d � � j d � S( u�
Accepts a dictionary entry containing GECOS field names and their values,
and returns a full GECOS comment string, to be used with usermod.
u {0},{1},{2},{3},{4}u fullnameu u
roomnumberu workphoneu homephoneu otheru ,( t formatt gett rstrip( t
gecos_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt _build_gecosM s
c C@ s | d k r d } n9 t | t j � s9 t j | � } n t j j j | � } t | � } | sd t
S| | | k rx t St j
| � } | | | <d d t | � | g } | d k r� t d d k r� | j d | f � n t d | d t
�t | � } t | � j | � | k S(
u:
Common code to change a user's GECOS information
u u usermodu -cu kernelu AIXu -Ru cmd.runt python_shellN( t NoneR
R R t text_typeR
R R R R R t Truet copyt deepcopyR" R t extendt __salt__t infoR ( R t keyt valuet roott pre_infot
gecos_datat cmdt post_info( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt
_update_gecosY s$
u c C@ s� d g } | r% | j d | g � n | d" k rG | j d | g � n | d# k ri | j d | g � n�| d
k r�| | k r�d } t d d k rSy� t j j j | � �p } xf | D]^ } t j j j | � } d | d
k r� q� n d | k r| j d t d | � g � n Pq� WWd
QXWq�t
k
rOt j d | d t
j �q�Xq�d } y| t j j j | � �a } xW | D]O } t j j j | � } d | d k r�q{n | j d | j � d g � Pq{WWd
QXWq�t
k
r�q�Xn |
r| j d � n0 t d d k r2t d d k r2| j d � n | rH| j d � n | d
k rj| j d | g � n | r�t d d k r�| j d � n | r�t d d k r�t d d k r�| j d � n t d d k r�| d
k r�| j d | g � q�n | j | � | d
k r;t d d k r;| j d | f � n t d | d t �} | d d! k ret S| r{t | | � n | r�t | | � n | r�t | | � n |
r�t | |
� n | r�t | | � n | r�t | | � n t S($ u�
Add a user to the minion
CLI Example:
.. code-block:: bash
salt '*' user.add name <uid> <gid> <groups> <home> <shell>
u useraddu -su u -uu -gu /etc/login.defsu kernelu OpenBSDu USERGROUPS_ENABi u yesu file.group_to_gidNu Error reading t exc_info_on_loglevelu /etc/usermgmt.confu groupi i����u -mu NetBSDu -Mu -lu -du AIXu -ou -ru -Lu -Ru cmd.run_allR# u retcodei ( Nu ( Nu ( R) R$ R R
R t filest fopenR R R* t OSErrort logt debugt loggingt DEBUGR R R t chgroupst
chfullnamet chroomnumbert chworkphonet chhomephonet chotherR& ( R t uidt gidt groupst homet shellt uniquet systemt fullnamet
roomnumbert workphonet homephonet othert
createhomet
loginclassR. t nologinitR1 t defs_filet fp_t linet
usermgmt_filet ret( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt addu s�
c C@ s d g } | r | j d � n | rU t d d k rU t d d k rU | j d � n | j | � | d k r� t d d k r� | j d | f � n t d | d t �} | d
d k r� t S| d
d k rt d
d k r� t Sd | d k sd | d k rt j d � t Sn t S( u�
Remove a user from the minion
CLI Example:
.. code-block:: bash
salt '*' user.delete name remove=True force=True
u userdelu -ru kernelu OpenBSDu AIXu -fu -Ru cmd.run_allR# u retcodei i u os_familyu Debianu var/mailu stderru var/spool/mailur While the userdel exited with code 12, this is a known bug on debian based distributions. See http://goo.gl/HH3FzTN( u Debian( R R R$ R) R* R R& R8 R9 ( R t removet forceR. R1 RU ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt delete� s&
&
c C@ sY d t k r | r t d Sg } x' t j � D] } | j t | � � q. W| t d <| S( u}
Return the list of all info for all users
CLI Example:
.. code-block:: bash
salt '*' user.getent
u user.getent( t __context__R t getpwallR t _format_info( t refreshRU R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt getent' s
c C@ s_ t | � } | | d k r t Sd d | | g } t d | d t �t | � j d � | k S( u{
Change the uid for a named user
CLI Example:
.. code-block:: bash
salt '*' user.chuid foo 4376
u uidu usermodu -uu cmd.runR# ( R+ R& R* R R ( R RB R/ R1 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt chuid; s
c C@ s� t | � } | | d k r t Sd d | | g } | d k rd t d d k rd | j d | f � n t d | d t �t | � j d � | k S(
u�
Change the default group of the user
CLI Example:
.. code-block:: bash
salt '*' user.chgid foo 4376
u gidu usermodu -gu kernelu AIXu -Ru cmd.runR# N( R+ R& R$ R R) R* R R ( R RC R. R/ R1 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt chgidM s
c C@ s� t | � } | | d k r t Sd d | | g } | d k rd t d d k rd | j d | f � n t d | d t �t | � j d � | k S(
u�
Change the default shell of the user
CLI Example:
.. code-block:: bash
salt '*' user.chshell foo /bin/zsh
u shellu usermodu -su kernelu AIXu -Ru cmd.runR# N( R+ R& R$ R R) R* R R ( R RF R. R/ R1 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt chshellc s
c C@ s� t | � } | | d k r t Sd d | g } | d k ra t d d k ra | j d | f � n | r� t d d k r� | j d � n | j | � t d | d
t �t | � j d � | k S( u�
Change the home directory of the user, pass True for persist to move files
to the new home directory if the old home directory exist.
CLI Example:
.. code-block:: bash
salt '*' user.chhome foo /home/users/foo True
u homeu usermodu -du kernelu AIXu -Ru OpenBSDu -mu cmd.runR# N( R+ R& R$ R R) R R* R R ( R RE t persistR. R/ R1 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt chhomey s
c
C@ s t | t j � r$ | j d � } n t t | � � } | t | � k rL t Sd g } t d d k r� | r� t d d k r� | j d � n | j d � n# | r� | j d � n
| j d � | rt d d k r| j d j
| � d d j
| � | g � n | j d j
| � | g � | d k rRt d d k rR| j d | f � n t d
| d t
�} t d d k r�t d d k r�| d d
k r�d | d k r�t } xE | D]= } d d | | g } t d | d t
�d
k r�t
} q�q�W| Sn | d d
k S( u�
Change the groups to which this user belongs
name
User to modify
groups
Groups to set for the user
append : False
If ``True``, append the specified group(s). Otherwise, this function
will replace the user's groups with the specified group(s).
CLI Examples:
.. code-block:: bash
salt '*' user.chgroups foo wheel,root
salt '*' user.chgroups foo wheel,root append=True
u ,u usermodu kernelu OpenBSDu AIXu -au -Gu -Su -Ru cmd.run_allR# u retcodei u not found inu stderru gpasswdu cmd.retcodeN( R
R R R t sett list_groupsR& R R R) t joinR$ R* R ( R RD R R. t ugrpsR1 t resultRU t group( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyR< � s8
0
c C@ s t | d | � S( u�
Change the user's Full Name
CLI Example:
.. code-block:: bash
salt '*' user.chfullname foo "Foo Bar"
u fullname( R3 ( R RI ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyR= � s
c C@ s t | d | � S( u
Change the user's Room Number
CLI Example:
.. code-block:: bash
salt '*' user.chroomnumber foo 123
u
roomnumber( R3 ( R RJ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyR> � s
c C@ s t | d | � S( u�
Change the user's Work Phone
CLI Example:
.. code-block:: bash
salt '*' user.chworkphone foo 7735550123
u workphone( R3 ( R RK ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyR? � s
c C@ s t | d | � S( u�
Change the user's Home Phone
CLI Example:
.. code-block:: bash
salt '*' user.chhomephone foo 7735551234
u homephone( R3 ( R RL ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyR@ � s
c C@ s t | d | � S( u�
Change the user's other GECOS attribute
CLI Example:
.. code-block:: bash
salt '*' user.chother foobar
u other( R3 ( R RM ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyRA s
c C@ s� t d d k r t S| t | � k r* t Sd d | | g } | d k r^ | j d | f � n t d | d t �t | � | k S( u�
Change the default login class of the user
.. note::
This function only applies to OpenBSD systems.
CLI Example:
.. code-block:: bash
salt '*' user.chloginclass foo staff
u kernelu OpenBSDu usermodu -Lu -Ru cmd.runR# N( R R t get_loginclassR& R$ R) R* ( R RO R. R1 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt chloginclass s
c C@ s< y t j t | � � } Wn t k
r- i SXt | � Sd S( un
Return user information
CLI Example:
.. code-block:: bash
salt '*' user.info root
N( R R R t KeyErrorR\ ( R R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyR+ , s
c C@ s� t d d k r t St d d | g d t �} xd | j � D]P } | j d � r= y | j d d � d } PWq� t t f k
r� q= q� Xq= q= Wd } | S(
u�
Get the login class of the user
.. note::
This function only applies to OpenBSD systems.
CLI Example:
.. code-block:: bash
salt '*' user.get_loginclass foo
u kernelu OpenBSDu cmd.run_stdoutu userinfoR# u classi u N( R R R* t
splitlinest
startswithR R$ t
ValueErrort
IndexError( R t userinfoRS RU ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyRj > s
c C@ s� t j j j | j � j d d � } x# t | � d k rI | j d � q' Wi | j d 6t | j
� d 6| j d 6| j
d 6| j d 6| j
d
6| j d 6| d d
6| d d 6| d d 6| d d 6| d d 6S( u1
Return user information in a pretty way
u ,i i u u gidu groupsu homeu nameu passwdu shellu uidi u fullnamei u
roomnumberi u workphonei u homephoneu other( R
R R R R R R R t pw_gidRe t pw_namet pw_dirt pw_passwdt pw_shellt pw_uid( R R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyR\ \ s $
u idc C@ s t d d d d | g � S( u�
Return the primary group of the named user
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' user.primary_group saltadmin
u cmd.runu idu -gu -n( R* ( R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt
primary_groupt s
c C@ s t j j j | � S( u�
Return a list of groups the named user belongs to
CLI Example:
.. code-block:: bash
salt '*' user.list_groups foo
( R
R t usert get_group_list( R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyRe � s
c C@ s& t g t j � D] } | j ^ q � S( ur
Return a list of all users
CLI Example:
.. code-block:: bash
salt '*' user.list_users
( t sortedR R[ Rs ( Ry ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt
list_users� s
c C@ s� t | � } | s* t d j | � � � n t | � } | rT t d j | � � � n d d | | g } | d k r� t d d k r� | j d | f � n t d | d t �t | � j d
� | k S( u�
Change the username for a named user
CLI Example:
.. code-block:: bash
salt '*' user.rename name new_name
u User '{0}' does not existu User '{0}' already existsu usermodu -lu kernelu AIXu -Ru cmd.runR# u nameN( R+ R R R$ R R) R* R R ( R t new_nameR. t current_infot new_infoR1 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt rename� s
(9 t __doc__t
__future__R R R R R& R t ImportErrorR R: R' t salt.utils.dataR
t salt.utils.filest salt.utils.decorators.patht salt.utils.stringutilst salt.utils.usert salt.exceptionsR t salt.extR t getLoggert __name__R8 R R R R R" R$ R3 RV RY R^ R_ R` Ra Rc R< R= R> R? R@ RA Rk R+ Rj R\ R t
decoratorst patht whichRx Re R| R� ( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/useradd.pyt <module>
st
s/ <
!
Mini Shell