CDIST-TYPE__USER - reference manual online

CDIST-TYPE__USER(7)                                                           CDIST-TYPE__USER(7)

NAME
       cdist-type__user - Manage users

DESCRIPTION
       This cdist type allows you to create or modify users on the target.

REQUIRED PARAMETERS
       None.

OPTIONAL PARAMETERS
       state
           absent or present, defaults to present

       comment
           see usermod(8)

       home
           see above

       gid
           see above

       password
           see above

       shell
           see above

       uid
           see above

BOOLEAN PARAMETERS
       system
           see useradd(8), apply only on user create

       create-home
           see useradd(8), apply only on user create

       remove-home
           see userdel(8), apply only on user delete

MESSAGES
       mod
           User is modified

       add
           New user added

EXAMPLES
           # Create user account for foobar with operating system default settings
           __user foobar

           # Same but with a different shell
           __user foobar --shell /bin/zsh

           # Same but for a system account
           __user foobar --system

           # Set explicit uid and home
           __user foobar --uid 1001 --shell /bin/zsh --home /home/foobar

           # Drop user if exists
           __user foobar --state absent

SEE ALSO
       ·   cdist-type(7)

       ·   usermod(8) or pw(8)

COPYING
       Copyright (C) 2011 Steven Armstrong. Free use of this software is granted under the terms
       of the GNU General Public License version 3 (GPLv3).

AUTHOR
       Steven Armstrong <steven-cdist--@--armstrong.cc>
           Author.

                                            04/07/2016                        CDIST-TYPE__USER(7)