diff docs/man/man8/ftjail-build-etcupdate-current-tmpl.rst @ 308:2102b46566f0

Implement "ftjail build-etcupdate-curent-tmpl". This allows to build a current tree suitable for using with etcupdate's default and extract modes: allow updating a system without having a corresponding source tree.
author Franz Glasner <fzglas.hg@dom66.de>
date Fri, 23 Sep 2022 00:37:33 +0200
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/man/man8/ftjail-build-etcupdate-current-tmpl.rst	Fri Sep 23 00:37:33 2022 +0200
@@ -0,0 +1,39 @@
+.. -*- coding: utf-8; indent-tabs-mode: nil; -*-
+
+ftjail-build-etcupdate-current-tmpl
+===================================
+
+Synopsis
+--------
+
+**ftjail build-etcupdate-current-tmpl** `directory` `tarball`
+
+
+Description
+-----------
+
+Build a tarball in `tarball` of a "current" tree from the template
+mounted at `directory`.
+
+This tarball can be used by the default and extract modes of
+:command:`etcupdate`. Using a tarball can allow :command:`etcupdate`
+to perform a merge without requiring a source tree that matches the
+currently installed world.  The tarball argument specifies the name of
+the file to create.  The file will be a :manpage:`tar(5)` file compressed with
+:manpage:`bzip2(1)`.
+
+Within `directory` the default database locations are assumed. They are
+:file:`{directory}/var/db/etcupdate/current`.
+
+
+Environment
+-----------
+
+All environment variables that affect :manpage:`tar(1)` are effective also.
+
+
+See Also
+--------
+
+:manpage:`ftjail(8)`, :manpage:`etcupdate(8)`,
+:manpage:`tar(1)`, :manpage:`tar(5)`