eeva/home-manager
1
0
Fork 0
mirror of https://github.com/nix-community/home-manager synced 2024-11-24 03:59:46 +01:00
Code Issues Releases Wiki Activity

deploy: ea1794a798

Browse source
This commit is contained in:
rycee 2021-11-26 08:27:09 +00:00
parent f3854a41e1
commit a48019f5c4
3 changed files with 52 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
index.html
View file

File diff suppressed because one or more lines are too long

43
options.html
View file

@ -2719,6 +2719,49 @@ or checksum database.
<home-manager/modules/programs/gpg.nix> <home-manager/modules/programs/gpg.nix>
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.homedir"></a><a class="term" href="options.html#opt-programs.gpg.homedir"><code class="option">programs.gpg.homedir</code></a></span></dt><dd><p>Directory to store keychains and configuration.</p><p><span class="emphasis"><em>Type:</em></span> path</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">"${config.home.homeDirectory}/.gnupg"</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">"${config.xdg.dataHome}/gnupg"</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/programs/gpg.nix#blob-path" target="_top"> </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.homedir"></a><a class="term" href="options.html#opt-programs.gpg.homedir"><code class="option">programs.gpg.homedir</code></a></span></dt><dd><p>Directory to store keychains and configuration.</p><p><span class="emphasis"><em>Type:</em></span> path</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">"${config.home.homeDirectory}/.gnupg"</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">"${config.xdg.dataHome}/gnupg"</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/programs/gpg.nix#blob-path" target="_top">
&lt;home-manager/modules/programs/gpg.nix&gt; &lt;home-manager/modules/programs/gpg.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.mutableKeys"></a><a class="term" href="options.html#opt-programs.gpg.mutableKeys"><code class="option">programs.gpg.mutableKeys</code></a></span></dt><dd><p>If set to <code class="literal">true</code>, you may manage your keyring as a user
using the <code class="literal">gpg</code> command. Upon activation, the keyring
will have managed keys added without overwriting unmanaged keys.
</p><p>
If set to <code class="literal">false</code>, the path
<code class="filename">$GNUPGHOME/pubring.kbx</code> will become an immutable
link to the Nix store, denying modifications.
</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">true</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/programs/gpg.nix#blob-path" target="_top">
&lt;home-manager/modules/programs/gpg.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.mutableTrust"></a><a class="term" href="options.html#opt-programs.gpg.mutableTrust"><code class="option">programs.gpg.mutableTrust</code></a></span></dt><dd><p>If set to <code class="literal">true</code>, you may manage trust as a user using
the <span class="command"><strong>gpg</strong></span> command. Upon activation, trusted keys have
their trust set without overwriting unmanaged keys.
</p><p>
If set to <code class="literal">false</code>, the path
<code class="filename">$GNUPGHOME/trustdb.gpg</code> will be
<span class="emphasis"><em>overwritten</em></span> on each activation, removing trust for
any unmanaged keys. Be careful to make a backup of your old
<code class="filename">trustdb.gpg</code> before switching to immutable trust!
</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">true</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/programs/gpg.nix#blob-path" target="_top">
&lt;home-manager/modules/programs/gpg.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.publicKeys"></a><a class="term" href="options.html#opt-programs.gpg.publicKeys"><code class="option">programs.gpg.publicKeys</code></a></span></dt><dd><p>A list of public keys to be imported into GnuPG. Note, these key files
will be copied into the world-readable Nix store.
</p><p><span class="emphasis"><em>Type:</em></span> list of submodules</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
[
]
</code></p><p><span class="emphasis"><em>Example:</em></span> </p><pre class="programlisting">[ { source = ./pubkeys.txt; } ]
</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/programs/gpg.nix#blob-path" target="_top">
&lt;home-manager/modules/programs/gpg.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.publicKeys._.source"></a><a class="term" href="options.html#opt-programs.gpg.publicKeys._.source"><code class="option">programs.gpg.publicKeys.*.source</code></a></span></dt><dd><p>Path of an OpenPGP public key file.
</p><p><span class="emphasis"><em>Type:</em></span> path</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/programs/gpg.nix#blob-path" target="_top">
&lt;home-manager/modules/programs/gpg.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.publicKeys._.text"></a><a class="term" href="options.html#opt-programs.gpg.publicKeys._.text"><code class="option">programs.gpg.publicKeys.*.text</code></a></span></dt><dd><p>Text of an OpenPGP public key.
</p><p><span class="emphasis"><em>Type:</em></span> null or string</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">null</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/programs/gpg.nix#blob-path" target="_top">
&lt;home-manager/modules/programs/gpg.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.publicKeys._.trust"></a><a class="term" href="options.html#opt-programs.gpg.publicKeys._.trust"><code class="option">programs.gpg.publicKeys.*.trust</code></a></span></dt><dd><p>The amount of trust you have in the key ownership and the care the
owner puts into signing other keys. The available levels are
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="literal">1</code></span></dt><dd><p>I don't know or won't say.</p></dd><dt><span class="term"><code class="literal">2</code></span></dt><dd><p>I do NOT trust.</p></dd><dt><span class="term"><code class="literal">3</code></span></dt><dd><p>I trust marginally.</p></dd><dt><span class="term"><code class="literal">4</code></span></dt><dd><p>I trust fully.</p></dd><dt><span class="term"><code class="literal">5</code></span></dt><dd><p>I trust ultimately.</p></dd></dl></div><p>
</p><p>
See <a class="link" href="https://www.gnupg.org/gph/en/manual/x334.html" target="_top">https://www.gnupg.org/gph/en/manual/x334.html</a>
for more.
</p><p><span class="emphasis"><em>Type:</em></span> null or one of 1, 2, 3, 4, 5</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">null</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/programs/gpg.nix#blob-path" target="_top">
&lt;home-manager/modules/programs/gpg.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.scdaemonSettings"></a><a class="term" href="options.html#opt-programs.gpg.scdaemonSettings"><code class="option">programs.gpg.scdaemonSettings</code></a></span></dt><dd><p>SCdaemon configuration options. Available options are described </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.gpg.scdaemonSettings"></a><a class="term" href="options.html#opt-programs.gpg.scdaemonSettings"><code class="option">programs.gpg.scdaemonSettings</code></a></span></dt><dd><p>SCdaemon configuration options. Available options are described
in the gpg scdaemon manpage: in the gpg scdaemon manpage:
<a class="link" href="https://www.gnupg.org/documentation/manuals/gnupg/Scdaemon-Options.html" target="_top">https://www.gnupg.org/documentation/manuals/gnupg/Scdaemon-Options.html</a>. <a class="link" href="https://www.gnupg.org/documentation/manuals/gnupg/Scdaemon-Options.html" target="_top">https://www.gnupg.org/documentation/manuals/gnupg/Scdaemon-Options.html</a>.

14
tools.html
View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix D. Tools</title><link rel="stylesheet" type="text/css" href="style.css" /><link rel="stylesheet" type="text/css" href="overrides.css" /><link rel="stylesheet" type="text/css" href="mono-blue.css" /><script src="highlight.pack.js" type="text/javascript"></script><script src="highlight.load.js" type="text/javascript"></script><meta name="generator" content="DocBook XSL Stylesheets V1.79.2" /><link rel="home" href="index.html" title="Home Manager Manual" /><link rel="up" href="index.html" title="Home Manager Manual" /><link rel="prev" href="nix-darwin-options.html" title="Appendix C. nix-darwin Module Options" /><link rel="next" href="release-notes.html" title="Appendix E. Release Notes" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix D. Tools</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="nix-darwin-options.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="ch-tools"></a>Appendix D. Tools</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="refentrytitle"><a href="tools.html#idm140737310240704"><span class="command"><strong>home-manager</strong></span> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix D. Tools</title><link rel="stylesheet" type="text/css" href="style.css" /><link rel="stylesheet" type="text/css" href="overrides.css" /><link rel="stylesheet" type="text/css" href="mono-blue.css" /><script src="highlight.pack.js" type="text/javascript"></script><script src="highlight.load.js" type="text/javascript"></script><meta name="generator" content="DocBook XSL Stylesheets V1.79.2" /><link rel="home" href="index.html" title="Home Manager Manual" /><link rel="up" href="index.html" title="Home Manager Manual" /><link rel="prev" href="nix-darwin-options.html" title="Appendix C. nix-darwin Module Options" /><link rel="next" href="release-notes.html" title="Appendix E. Release Notes" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix D. Tools</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="nix-darwin-options.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="ch-tools"></a>Appendix D. Tools</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="refentrytitle"><a href="tools.html#idm140737310198144"><span class="command"><strong>home-manager</strong></span>
</a></span><span class="refpurpose"> — reconfigure a user environment</span></dt></dl></div><div class="refentry"><a id="idm140737310240704"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p><span class="command"><strong>home-manager</strong></span> </a></span><span class="refpurpose"> — reconfigure a user environment</span></dt></dl></div><div class="refentry"><a id="idm140737310198144"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p><span class="command"><strong>home-manager</strong></span>
— reconfigure a user environment</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">home-manager</code> { — reconfigure a user environment</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">home-manager</code> {
build build
| |
@ -82,7 +82,7 @@
| |
--verbose --verbose
} }
]</p></div></div><div class="refsection"><a id="idm140737310203872"></a><h2>Description</h2><p> ]</p></div></div><div class="refsection"><a id="idm140737310161168"></a><h2>Description</h2><p>
This command updates the user environment so that it corresponds to the This command updates the user environment so that it corresponds to the
configuration specified in <code class="filename">~/.config/nixpkgs/home.nix</code> or <code class="filename">~/.config/nixpkgs/flake.nix</code>. configuration specified in <code class="filename">~/.config/nixpkgs/home.nix</code> or <code class="filename">~/.config/nixpkgs/flake.nix</code>.
</p><p> </p><p>
@ -151,7 +151,7 @@
available for immediate garbage collection. available for immediate garbage collection.
</p></li></ul></div><p> </p></li></ul></div><p>
</p></dd></dl></div><p> </p></dd></dl></div><p>
</p></div><div class="refsection"><a id="idm140737310166224"></a><h2>Options</h2><p> </p></div><div class="refsection"><a id="idm140737310123472"></a><h2>Options</h2><p>
The tool accepts the options The tool accepts the options
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"> </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="option">-A <em class="replaceable"><code>attrPath</code></em></code> <code class="option">-A <em class="replaceable"><code>attrPath</code></em></code>
@ -259,15 +259,15 @@
<code class="option">--verbose</code> <code class="option">--verbose</code>
</span></dt><dd><p> </span></dt><dd><p>
Activates verbose output. Activates verbose output.
</p></dd></dl></div></div><div class="refsection"><a id="idm140737310102512"></a><h2>Files</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"> </p></dd></dl></div></div><div class="refsection"><a id="idm140737310059856"></a><h2>Files</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="filename">~/.local/share/home-manager/news-read-ids</code> <code class="filename">~/.local/share/home-manager/news-read-ids</code>
</span></dt><dd><p> </span></dt><dd><p>
Identifiers of news items that have been shown. Can be deleted to reset Identifiers of news items that have been shown. Can be deleted to reset
the read news indicator. the read news indicator.
</p></dd></dl></div></div><div class="refsection"><a id="idm140737310099216"></a><h2>Bugs</h2><p> </p></dd></dl></div></div><div class="refsection"><a id="idm140737310056560"></a><h2>Bugs</h2><p>
Please report any bugs on the Please report any bugs on the
<a class="link" href="https://github.com/nix-community/home-manager/issues" target="_top">project <a class="link" href="https://github.com/nix-community/home-manager/issues" target="_top">project
issue tracker</a>. issue tracker</a>.
</p></div><div class="refsection"><a id="idm140737310097216"></a><h2>See also</h2><p> </p></div><div class="refsection"><a id="idm140737310054560"></a><h2>See also</h2><p>
<span class="citerefentry"><span class="refentrytitle">home-configuration.nix</span>(5)</span> <span class="citerefentry"><span class="refentrytitle">home-configuration.nix</span>(5)</span>
</p></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="nix-darwin-options.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix C. nix-darwin Module Options </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix E. Release Notes</td></tr></table></div></body></html> </p></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="nix-darwin-options.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix C. nix-darwin Module Options </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix E. Release Notes</td></tr></table></div></body></html>