1CDIST-TYPE__DOT_FILE(7)              cdist             CDIST-TYPE__DOT_FILE(7)
2
3
4

NAME

6       cdist-type__dot_file - install file under user's home directory
7

DESCRIPTION

9       This  type  installs a file (=__object_id) under user's home directory,
10       providing a way to install per-user configuration files. File owner and
11       group is deduced from user, for who file is installed.
12
13       Unlike regular __file type, you do not need make any assumptions, where
14       user's home directory is.
15

REQUIRED PARAMETERS

17       user   User, for who file is installed
18

OPTIONAL PARAMETERS

20       mode   forwarded to __file type
21
22       state  forwarded to __file type
23
24       source forwarded to __file type
25

MESSAGES

27       This type inherits all messages from file type, and do not add any new.
28

EXAMPLES

30          # Install .forward file for user 'alice'. Since state is 'present',
31          # user is not meant to edit this file, all changes will be overridden.
32          # It is good idea to put warning about it in file itself.
33          __dot_file .forward --user alice --source "$__files/forward"
34
35          # Install .muttrc for user 'bob', if not already present. User can safely
36          # edit it, his changes will not be overwritten.
37          __dot_file .muttrc --user bob --source "$__files/recommended_mutt_config" --state exists
38
39
40          # Install default xmonad config for user 'eve'. Parent directory is created automatically.
41          __dot_file .xmonad/xmonad.hs --user eve --state exists --source "$__files/xmonad.hs"
42

SEE ALSO

44       cdist-type__file(7)
45

COPYING

47       Copyright (C) 2015 Dmitry Bogatov. Free use of this software is granted
48       under  the  terms  of the GNU General Public License version 3 or later
49       (GPLv3+).
50

52       ungleich GmbH 2019
53
54
55
56
576.3.0                            Dec 12, 2019          CDIST-TYPE__DOT_FILE(7)
Impressum