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

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

ungleich GmbH 2021 7.0.0 Sep 11, 2024 CDIST-TYPE__DOT_FILE(7)

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

# Install .forward file for user 'alice'. Since state is 'present', # user is not meant to edit this file, all changes will be overridden. # It is good idea to put warning about it in file itself. __dot_file .forward --user alice --source "$__files/forward" # Install .muttrc for user 'bob', if not already present. User can safely # edit it, his changes will not be overwritten. __dot_file .muttrc --user bob --source "$__files/recommended_mutt_config" --state exists # Install default xmonad config for user 'eve'. Parent directory is created automatically. __dot_file .xmonad/xmonad.hs --user eve --state exists --source "$__files/xmonad.hs" # install .vimrc for root and some users for user in root userx usery userz; do __dot_file "${user}_dot_vimrc" \ --user $user \ --file .vimrc \ --state exists \ --source "$__files/$user/.vimrc" done

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

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

dirmode forwarded to __directory type as mode mode forwarded to __file type state forwarded to __file type source forwarded to __file type file forwarded to __file type This can be used if multiple users need to have a dotfile updated, which will result in duplicate object id errors. When using the file parameter the object id can be some unique value.

user User, for who file is installed

cdist-type__file(7)