mirror of
https://github.com/nix-community/home-manager.git
synced 2025-12-16 14:01:08 +01:00
deploy: b5ed4afc22
This commit is contained in:
parent
f84f1f5ce0
commit
15bf332bbb
1 changed files with 246 additions and 10 deletions
256
options.xhtml
256
options.xhtml
|
|
@ -118458,27 +118458,263 @@ null or string</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt>
|
<dt>
|
||||||
<span class="term">
|
<span class="term">
|
||||||
<a id="opt-systemd.user.tmpfiles.rules"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.rules"><code class="option">systemd.user.tmpfiles.rules</code>
|
<a id="opt-systemd.user.tmpfiles.settings"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings"><code class="option">systemd.user.tmpfiles.settings</code>
|
||||||
</a>
|
</a>
|
||||||
</span>
|
</span>
|
||||||
</dt>
|
</dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>Rules for creating and cleaning up temporary files
|
<p>Declare systemd-tmpfiles rules to create, delete, and clean up volatile
|
||||||
automatically. See
|
and temporary files and directories.</p><p>Even though the service is called <code class="literal">*tmp*files</code> you can also create
|
||||||
<a class="link" href="https://www.freedesktop.org/software/systemd/man/tmpfiles.d.html" target="_top"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a>
|
persistent files.</p>
|
||||||
for the exact format.</p>
|
|
||||||
|
|
||||||
<p><span class="emphasis"><em>Type:</em></span>
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
list of string</p>
|
attribute set of (submodule)</p>
|
||||||
|
|
||||||
<p><span class="emphasis"><em>Default:</em></span>
|
<p><span class="emphasis"><em>Default:</em></span>
|
||||||
<code class="literal">[ ]</code></p>
|
<code class="literal">{ }</code></p>
|
||||||
|
|
||||||
<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting">[
|
<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting">{
|
||||||
"L /home/user/Documents - - - - /mnt/data/Documents"
|
cache = {
|
||||||
]
|
rules = {
|
||||||
|
"%C" = {
|
||||||
|
d = {
|
||||||
|
age = "4 weeks";
|
||||||
|
group = "alice";
|
||||||
|
mode = "0755";
|
||||||
|
user = "alice";
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
||||||
|
}
|
||||||
</code></pre>
|
</code></pre>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
|
<tr><td>
|
||||||
|
<code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix" target="_top">
|
||||||
|
<home-manager/modules/misc/tmpfiles.nix>
|
||||||
|
</a></code>
|
||||||
|
</td></tr>
|
||||||
|
</table>
|
||||||
|
</dd>
|
||||||
|
<dt>
|
||||||
|
<span class="term">
|
||||||
|
<a id="opt-systemd.user.tmpfiles.settings._config-name_.purgeOnChange"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings._config-name_.purgeOnChange"><code class="option">systemd.user.tmpfiles.settings.<config-name>.purgeOnChange</code>
|
||||||
|
</a>
|
||||||
|
</span>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
<p>Whether the rules that are marked for purging, will automatically
|
||||||
|
be purged when the set of rules changes.</p><p>See <span class="citerefentry"><span class="refentrytitle">systemd-tmpfiles</span>(8)</span> for details about purging.</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
|
boolean</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Default:</em></span>
|
||||||
|
<code class="literal">false</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
|
<tr><td>
|
||||||
|
<code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix" target="_top">
|
||||||
|
<home-manager/modules/misc/tmpfiles.nix>
|
||||||
|
</a></code>
|
||||||
|
</td></tr>
|
||||||
|
</table>
|
||||||
|
</dd>
|
||||||
|
<dt>
|
||||||
|
<span class="term">
|
||||||
|
<a id="opt-systemd.user.tmpfiles.settings._config-name_.rules"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings._config-name_.rules"><code class="option">systemd.user.tmpfiles.settings.<config-name>.rules</code>
|
||||||
|
</a>
|
||||||
|
</span>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
<p>The rules contained in this configuration.</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
|
non-empty attribute set of non-empty attribute set of (submodule)</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting">{
|
||||||
|
"%C" = {
|
||||||
|
d = {
|
||||||
|
age = "4 weeks";
|
||||||
|
group = "alice";
|
||||||
|
mode = "0755";
|
||||||
|
user = "alice";
|
||||||
|
};
|
||||||
|
};
|
||||||
|
}
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
|
<tr><td>
|
||||||
|
<code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix" target="_top">
|
||||||
|
<home-manager/modules/misc/tmpfiles.nix>
|
||||||
|
</a></code>
|
||||||
|
</td></tr>
|
||||||
|
</table>
|
||||||
|
</dd>
|
||||||
|
<dt>
|
||||||
|
<span class="term">
|
||||||
|
<a id="opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.age"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.age"><code class="option">systemd.user.tmpfiles.settings.<config-name>.rules.<path>.<tmpfiles-type>.age</code>
|
||||||
|
</a>
|
||||||
|
</span>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
<p>Delete a file when it reaches a certain age.</p><p>If a file or directory is older than the current time minus the age
|
||||||
|
field, it is deleted.</p><p>If set to <code class="literal">"-"</code>, no automatic clean-up is done.</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
|
string</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Default:</em></span>
|
||||||
|
<code class="literal">"-"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Example:</em></span>
|
||||||
|
<code class="literal">"10d"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
|
<tr><td>
|
||||||
|
<code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix" target="_top">
|
||||||
|
<home-manager/modules/misc/tmpfiles.nix>
|
||||||
|
</a></code>
|
||||||
|
</td></tr>
|
||||||
|
</table>
|
||||||
|
</dd>
|
||||||
|
<dt>
|
||||||
|
<span class="term">
|
||||||
|
<a id="opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.argument"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.argument"><code class="option">systemd.user.tmpfiles.settings.<config-name>.rules.<path>.<tmpfiles-type>.argument</code>
|
||||||
|
</a>
|
||||||
|
</span>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
<p>An argument whose meaning depends on the type of operation.</p><p>Please see the upstream documentation for the meaning of this
|
||||||
|
parameter in different situations: <a class="link" href="https://www.freedesktop.org/software/systemd/man/tmpfiles.d.html" target="_top"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
|
string</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Default:</em></span>
|
||||||
|
<code class="literal">""</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Example:</em></span>
|
||||||
|
<code class="literal">""</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
|
<tr><td>
|
||||||
|
<code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix" target="_top">
|
||||||
|
<home-manager/modules/misc/tmpfiles.nix>
|
||||||
|
</a></code>
|
||||||
|
</td></tr>
|
||||||
|
</table>
|
||||||
|
</dd>
|
||||||
|
<dt>
|
||||||
|
<span class="term">
|
||||||
|
<a id="opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.group"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.group"><code class="option">systemd.user.tmpfiles.settings.<config-name>.rules.<path>.<tmpfiles-type>.group</code>
|
||||||
|
</a>
|
||||||
|
</span>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
<p>The group of the file.</p><p>This may either be a numeric ID or a user/group name.</p><p>If omitted or when set to <code class="literal">"-"</code>, the user and group of the user who
|
||||||
|
invokes systemd-tmpfiles is used.</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
|
string</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Default:</em></span>
|
||||||
|
<code class="literal">"-"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Example:</em></span>
|
||||||
|
<code class="literal">"root"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
|
<tr><td>
|
||||||
|
<code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix" target="_top">
|
||||||
|
<home-manager/modules/misc/tmpfiles.nix>
|
||||||
|
</a></code>
|
||||||
|
</td></tr>
|
||||||
|
</table>
|
||||||
|
</dd>
|
||||||
|
<dt>
|
||||||
|
<span class="term">
|
||||||
|
<a id="opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.mode"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.mode"><code class="option">systemd.user.tmpfiles.settings.<config-name>.rules.<path>.<tmpfiles-type>.mode</code>
|
||||||
|
</a>
|
||||||
|
</span>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
<p>The file access mode to use when creating this file or directory.</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
|
string</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Default:</em></span>
|
||||||
|
<code class="literal">"-"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Example:</em></span>
|
||||||
|
<code class="literal">"0755"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
|
<tr><td>
|
||||||
|
<code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix" target="_top">
|
||||||
|
<home-manager/modules/misc/tmpfiles.nix>
|
||||||
|
</a></code>
|
||||||
|
</td></tr>
|
||||||
|
</table>
|
||||||
|
</dd>
|
||||||
|
<dt>
|
||||||
|
<span class="term">
|
||||||
|
<a id="opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.type"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.type"><code class="option">systemd.user.tmpfiles.settings.<config-name>.rules.<path>.<tmpfiles-type>.type</code>
|
||||||
|
</a>
|
||||||
|
</span>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
<p>The type of operation to perform on the file.</p><p>The type consists of a single letter and optionally one or more
|
||||||
|
modifier characters.</p><p>Please see the upstream documentation for the available types and
|
||||||
|
more details: <a class="link" href="https://www.freedesktop.org/software/systemd/man/tmpfiles.d.html" target="_top"><span class="citerefentry"><span class="refentrytitle">tmpfiles.d</span>(5)</span></a></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
|
string <span class="emphasis"><em>(read only)</em></span></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Default:</em></span>
|
||||||
|
<code class="literal">"‹tmpfiles-type›"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Example:</em></span>
|
||||||
|
<code class="literal">"d"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
|
<tr><td>
|
||||||
|
<code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix" target="_top">
|
||||||
|
<home-manager/modules/misc/tmpfiles.nix>
|
||||||
|
</a></code>
|
||||||
|
</td></tr>
|
||||||
|
</table>
|
||||||
|
</dd>
|
||||||
|
<dt>
|
||||||
|
<span class="term">
|
||||||
|
<a id="opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.user"></a><a class="term" href="options.xhtml#opt-systemd.user.tmpfiles.settings._config-name_.rules._path_._tmpfiles-type_.user"><code class="option">systemd.user.tmpfiles.settings.<config-name>.rules.<path>.<tmpfiles-type>.user</code>
|
||||||
|
</a>
|
||||||
|
</span>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
<p>The user of the file.</p><p>This may either be a numeric ID or a user/group name.</p><p>If omitted or when set to <code class="literal">"-"</code>, the user and group of the user who
|
||||||
|
invokes systemd-tmpfiles is used.</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Type:</em></span>
|
||||||
|
string</p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Default:</em></span>
|
||||||
|
<code class="literal">"-"</code></p>
|
||||||
|
|
||||||
|
<p><span class="emphasis"><em>Example:</em></span>
|
||||||
|
<code class="literal">"root"</code></p>
|
||||||
|
|
||||||
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
<p><span class="emphasis"><em>Declared by:</em></span></p>
|
||||||
<table border="0" summary="Simple list" class="simplelist">
|
<table border="0" summary="Simple list" class="simplelist">
|
||||||
<tr><td>
|
<tr><td>
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue