iRework the manpage a little - drist - a remote deployment tool	Err	bitreich.org	70
hgit clone git://bitreich.org/drist/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/drist/	URL:git://bitreich.org/drist/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/drist/	bitreich.org	70
1Log	/scm/drist/log.gph	bitreich.org	70
1Files	/scm/drist/files.gph	bitreich.org	70
1Refs	/scm/drist/refs.gph	bitreich.org	70
1Tags	/scm/drist/tag	bitreich.org	70
1README	/scm/drist/file/README.gph	bitreich.org	70
1LICENSE	/scm/drist/file/LICENSE.gph	bitreich.org	70
i---	Err	bitreich.org	70
1commit b62625b79ee16f841d0a3693aea3d8521cc6a2ba	/scm/drist/commit/b62625b79ee16f841d0a3693aea3d8521cc6a2ba.gph	bitreich.org	70
1parent f87b55ae60ad8e173107eb34fbff84f8d64afc7b	/scm/drist/commit/f87b55ae60ad8e173107eb34fbff84f8d64afc7b.gph	bitreich.org	70
hAuthor: Quentin Rameau <quinq@fifth.space>	URL:mailto:quinq@fifth.space	bitreich.org	70
iDate:   Thu, 19 Jul 2018 23:33:42 +0200	Err	bitreich.org	70
i	Err	bitreich.org	70
iRework the manpage a little	Err	bitreich.org	70
i	Err	bitreich.org	70
iDiffstat:	Err	bitreich.org	70
i  M drist.1                             |      72 ++++++++++++++++++-------------	Err	bitreich.org	70
i	Err	bitreich.org	70
i1 file changed, 42 insertions(+), 30 deletions(-)	Err	bitreich.org	70
i---	Err	bitreich.org	70
1diff --git a/drist.1 b/drist.1	/scm/drist/file/drist.1.gph	bitreich.org	70
i@@ -15,36 +15,40 @@ is a tool to configure remote servers using	Err	bitreich.org	70
i and	Err	bitreich.org	70
i .Xr rsync 1 .	Err	bitreich.org	70
i .Nm	Err	bitreich.org	70
i-has been designed to be simple, so it may not offer features you want.	Err	bitreich.org	70
i+has been designed to be simple, so it may not offer all the features	Err	bitreich.org	70
i+you want.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i When you run	Err	bitreich.org	70
i-.Nm	Err	bitreich.org	70
i-, it will look at special directories in the current working directory.	Err	bitreich.org	70
i+.Nm Ns	Err	bitreich.org	70
i+, it will look at a set of special directories in the current working	Err	bitreich.org	70
i+directory.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-The whole sequence is the following, with HOSTNAME being the result of	Err	bitreich.org	70
i+Here is the whole sequence, with	Err	bitreich.org	70
i+.Em HOSTNAME	Err	bitreich.org	70
i+being the result of	Err	bitreich.org	70
i .Ql uname -n	Err	bitreich.org	70
i-on the remote system.	Err	bitreich.org	70
i+on the remote system:	Err	bitreich.org	70
i 	Err	bitreich.org	70
i .Bl -enum -offset indent -compact	Err	bitreich.org	70
i .It	Err	bitreich.org	70
i if folder	Err	bitreich.org	70
i .Ar files	Err	bitreich.org	70
i-exists, files in it are copied on	Err	bitreich.org	70
i+exists, its content is copied to	Err	bitreich.org	70
i .Ar server	Err	bitreich.org	70
i .It	Err	bitreich.org	70
i if folder	Err	bitreich.org	70
i-.Ar files-HOSTNAME	Err	bitreich.org	70
i-exists, files in it are copied on	Err	bitreich.org	70
i+.Ar files- Ns Em HOSTNAME	Err	bitreich.org	70
i+exists, its content copied to	Err	bitreich.org	70
i .Ar server	Err	bitreich.org	70
i .It	Err	bitreich.org	70
i if folder	Err	bitreich.org	70
i .Ar absent	Err	bitreich.org	70
i-exists, files in it are removed remotely on	Err	bitreich.org	70
i+exists, filenames in it are removed from	Err	bitreich.org	70
i .Ar server	Err	bitreich.org	70
i .It	Err	bitreich.org	70
i if folder	Err	bitreich.org	70
i-.Ar absent-HOSTNAME	Err	bitreich.org	70
i-exists, files in it are removed remotely on	Err	bitreich.org	70
i+.Ar absent- Ns Em HOSTNAME	Err	bitreich.org	70
i+exists, filenames in it are removed from	Err	bitreich.org	70
i .Ar server	Err	bitreich.org	70
i .It	Err	bitreich.org	70
i if file	Err	bitreich.org	70
i@@ -53,49 +57,57 @@ exists, it is executed remotely on	Err	bitreich.org	70
i .Ar server	Err	bitreich.org	70
i .It	Err	bitreich.org	70
i if file	Err	bitreich.org	70
i-.Ar script-HOSTNAME	Err	bitreich.org	70
i+.Ar script- Ns Em HOSTNAME	Err	bitreich.org	70
i exists, it is executed remotely on	Err	bitreich.org	70
i .Ar server	Err	bitreich.org	70
i .El	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-If directory	Err	bitreich.org	70
i+The presence of each of those files or directories is optional.	Err	bitreich.org	70
i+	Err	bitreich.org	70
i+If the directory	Err	bitreich.org	70
i .Ar files	Err	bitreich.org	70
i-is present, the content of this folder will be copied on the remote server	Err	bitreich.org	70
i+is present, its content will be copied to the remote	Err	bitreich.org	70
i .Ar server	Err	bitreich.org	70
i-from the root filesystem /. You can create	Err	bitreich.org	70
i-.Ar files-HOSTNAME	Err	bitreich.org	70
i+relatively to the root / directory. You can create	Err	bitreich.org	70
i+.Ar files- Ns Em HOSTNAME	Err	bitreich.org	70
i with	Err	bitreich.org	70
i-.Ar HOSTNAME	Err	bitreich.org	70
i+.Em HOSTNAME	Err	bitreich.org	70
i being the result of the command	Err	bitreich.org	70
i .Ql uname -n	Err	bitreich.org	70
i-on the remote server. The content of this foldre will be copied on the remote server	Err	bitreich.org	70
i-after the	Err	bitreich.org	70
i+on the remote server. The content of this folder will be copied to the	Err	bitreich.org	70
i+remote server after the	Err	bitreich.org	70
i .Ar files	Err	bitreich.org	70
i-directory. This folder is useful if you need to add some files only on certains servers.	Err	bitreich.org	70
i+directory has been processed. This folder is useful for adding	Err	bitreich.org	70
i+.Em HOSTNAME Ns -specific	Err	bitreich.org	70
i+files.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i After the files are copied,	Err	bitreich.org	70
i .Nm	Err	bitreich.org	70
i will look at two the folders	Err	bitreich.org	70
i .Ar absent	Err	bitreich.org	70
i and	Err	bitreich.org	70
i-.Ar absent-HOSTNAME	Err	bitreich.org	70
i+.Ar absent Ns Em HOSTNAME	Err	bitreich.org	70
i in the current working directory.	Err	bitreich.org	70
i .Nm	Err	bitreich.org	70
i-will remotely delete all files listed in the tree of the directory.	Err	bitreich.org	70
i+will remotely delete all files listed in this directory tree.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i Finally, the file	Err	bitreich.org	70
i .Ar script	Err	bitreich.org	70
i-be copied on the remote server and then executed and deleted after execution	Err	bitreich.org	70
i-(shall the script succeed or fail). If	Err	bitreich.org	70
i-.Ar script-HOSTNAME	Err	bitreich.org	70
i-exists, it will be procedded too in the same way. This is useful if you need 	Err	bitreich.org	70
i-to run commands on a particular servers.	Err	bitreich.org	70
i+be copied to the remote server, executed and deleted (shall the script	Err	bitreich.org	70
i+succeed or not). If	Err	bitreich.org	70
i+.Ar script- Ns Em HOSTNAME	Err	bitreich.org	70
i+exists, it will be processed in the same way. This is useful if you	Err	bitreich.org	70
i+need to run	Err	bitreich.org	70
i+.Em HOSTNAME Ns -specific	Err	bitreich.org	70
i+commands.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-I recommend to write small "modules" installing required packages for a task and providing	Err	bitreich.org	70
i-the files needed rather than an all-in-one module to deploy an entire system.	Err	bitreich.org	70
i+I recommend writing small "modules" which would install the required	Err	bitreich.org	70
i+packages for a task and provide the files needed, rather than writing a	Err	bitreich.org	70
i+full-blown module for deploying an entire system at once.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i .Nm 	Err	bitreich.org	70
i-does not take care of permissions and ownership. Thoses should be modified by the	Err	bitreich.org	70
i+does not handle file permissions and ownership. Thoses should be	Err	bitreich.org	70
i+modified by the	Err	bitreich.org	70
i .Ar script	Err	bitreich.org	70
i file.	Err	bitreich.org	70
i .	Err	bitreich.org	70
.