diff options
author | Diego Elio 'Flameeyes' Pettenò <flameeyes@gmail.com> | 2010-01-06 17:45:03 +0100 |
---|---|---|
committer | Diego Elio 'Flameeyes' Pettenò <flameeyes@gmail.com> | 2010-01-06 17:45:03 +0100 |
commit | 5e009ca8cea2a1679d37bb8c795cde205e6df44d (patch) | |
tree | 59c8bf9c9c765608d90575d8a495059629a22713 | |
parent | Use index.html as output filename for all pages. (diff) | |
download | devmanual-5e009ca8cea2a1679d37bb8c795cde205e6df44d.tar.gz devmanual-5e009ca8cea2a1679d37bb8c795cde205e6df44d.tar.bz2 devmanual-5e009ca8cea2a1679d37bb8c795cde205e6df44d.zip |
Convert config-protect short chapter.
-rw-r--r-- | chunk.toc | 1 | ||||
-rw-r--r-- | content/general-concepts.xmli | 1 | ||||
-rw-r--r-- | content/general-concepts/config-protect.xmli | 27 |
3 files changed, 29 insertions, 0 deletions
@@ -5,6 +5,7 @@ <d:tocentry linkend="quickstart"><?dbhtml filename="quickstart/index.html"?></d:tocentry> <d:tocentry linkend="general-concepts"><?dbhtml filename="general-concepts/index.html"?> <d:tocentry linkend="general-concepts.autotools"><?dbhtml filename="general-concepts/autotools/index.html"?></d:tocentry> + <d:tocentry linkend="general-concepts.config-protect"><?dbhtml filename="general-concepts/config-protect/index.html"?></d:tocentry> </d:tocentry> </d:tocentry> </toc> diff --git a/content/general-concepts.xmli b/content/general-concepts.xmli index f253e9c..b4b762c 100644 --- a/content/general-concepts.xmli +++ b/content/general-concepts.xmli @@ -14,5 +14,6 @@ </partintro> <xi:include parse="xml" href="general-concepts/autotools.xmli" /> + <xi:include parse="xml" href="general-concepts/config-protect.xmli" /> </part>
\ No newline at end of file diff --git a/content/general-concepts/config-protect.xmli b/content/general-concepts/config-protect.xmli new file mode 100644 index 0000000..dcbf758 --- /dev/null +++ b/content/general-concepts/config-protect.xmli @@ -0,0 +1,27 @@ +<?xml version="1.0" encoding="utf-8"?> +<chapter xmlns="http://docbook.org/ns/docbook" + xmlns:xl="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/XInclude" + xml:id="general-concepts.config-protect"> + <title>Configuration File Protection</title> + + <para> + Portage includes a system for configuration file protection which means ebuilds don't have to worry about + accidentally clobbering files in <filename>/etc</filename>. This is known as 'protection', and it is controlled by + the <varname>CONFIG_PROTECT</varname> and <varname>CONFIG_PROTECT_MASK</varname> variables. + </para> + + <para> + Any directory which is listed in <varname>CONFIG_PROTECT</varname> (and any subdirectories thereof), except for any + which are listed in <varname>CONFIG_PROTECT_MASK</varname> (and subdirectories) are automatically 'protected' by + Portage when copying an image from <varname>DESTDIR</varname> to <varname>ROOT</varname>. Rather than installing + protected files directly, Portage will install them as <filename>._cfg0000_filename</filename>. These can then be + processed by the <command>etc-update</command> or <command>dispatch-conf</command> files at the user's discretion. + </para> + + <para> + Packages must <emphasis>not</emphasis> attempt to override this system via <function>pkg_postinst</function> or + similar. If you need a file renamed, removed or changed in a particular way, you should display a message informing + the user. + </para> +</chapter> |