Skip to contentSkip to conversation

dev-manual/packages.rst: document gpg-agent configuration for parallel signing

PATCH Adarsh Jagadish Kamini 1 participant 1 message Nov 11 1 message not in the archive

lore
Share & tools
lore
#1 lore raw
In reply to a message not in the archive
Quoted 45 lines · Adarsh Jagadish Kamini via openembedded-core

OE-Core no longer passes auto-expand-secmem through --agent-program. Document how to enable it in gpg-agent.conf and restart the agent to avoid secure-memory exhaustion during parallel signing.

[YOCTO #16480]

AI-Generated: Uses Kiro (claude-opus-5.5)

---
  documentation/dev-manual/packages.rst | 20 ++++++++++++++++++++
  1 file changed, 20 insertions(+)
documentation/dev-manual/packages.rst +20 -1
index 380d806be..f05ade8b4 100644
@@ -905,6 +905,26 @@ related to signed package feeds are available:
     "ASC", which is the default and specifies ascii armored, and "BIN",
     which specifies binary.
 
+Configuring the GnuPG Agent
+---------------------------
+
+Parallel signing can exhaust ``gpg-agent``'s secure memory, causing
+"Cannot allocate memory" errors. Add the following to ``gpg-agent.conf``
+in the GnuPG home directory used for signing (``GPG_PATH`` if set, or
+GnuPG's default home directory, normally ``~/.gnupg``)::
+
+   auto-expand-secmem
+
+The OpenEmbedded build system does not set this option. Stop any running
+agent for that directory so the next signing operation starts it with
+the new configuration:
+
+.. code-block:: console
+
+   $ gpgconf --homedir /path/to/gpg/home --kill gpg-agent
+
+Omit ``--homedir /path/to/gpg/home`` to use GnuPG's default home directory.
+
  Testing Packages With ptest
  ===========================
 
 
-=-=-=-=-=-=-=-=-=-=-=-
Quoted 6 lines

Links: You receive all messages sent to this group.
View/Reply Online (#250026): https://lists.openembedded.org/g/openembedded-core/message/250026
Mute This Topic: https://lists.openembedded.org/mt/122211768/10182374
Group Owner: [email protected]
Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub [[email protected]]
-=-=-=-=-=-=-=-=-=-=-=-

Hi,
Please ignore this patch, I will send it to the documentation mailing list.

Thanks!