1
0
Fork 0
mirror of https://github.com/nix-community/home-manager synced 2024-12-25 19:29:47 +01:00
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

File diff suppressed because one or more lines are too long

View file

@ -2719,6 +2719,49 @@ or checksum database.
<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">
&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
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>.

View file

@ -1,6 +1,6 @@
<?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>
</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>
<!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="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> {
build
|
@ -82,7 +82,7 @@
|
--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
configuration specified in <code class="filename">~/.config/nixpkgs/home.nix</code> or <code class="filename">~/.config/nixpkgs/flake.nix</code>.
</p><p>
@ -151,7 +151,7 @@
available for immediate garbage collection.
</p></li></ul></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
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="option">-A <em class="replaceable"><code>attrPath</code></em></code>
@ -259,15 +259,15 @@
<code class="option">--verbose</code>
</span></dt><dd><p>
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>
</span></dt><dd><p>
Identifiers of news items that have been shown. Can be deleted to reset
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
<a class="link" href="https://github.com/nix-community/home-manager/issues" target="_top">project
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>
</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>