---
doc/Makefile.local | 2 ++
doc/examples/bwrap.sh | 9 +++++++++
doc/man1/notmuch-config.rst | 4 ++++
3 files changed, 15 insertions(+)
create mode 100755 doc/examples/bwrap.sh
diff --git a/doc/Makefile.local b/doc/Makefile.local
index 4edc4b1c..64e51475 100644
--- a/doc/Makefile.local
+++ b/doc/Makefile.local
@@ -39,6 +39,7 @@ COPY_INFO1 := $(patsubst
$(DOCBUILDDIR)/man/man1/%.1,$(DOCBUILDDIR)/texinfo/%.in
INFO_INFO_FILES := $(INFO_TEXI_FILES:.texi=.info) $(COPY_INFO1)
EXAMPLES_FILES := doc/examples/firejail.profile
+EXAMPLES_FILES_EXEC := doc/examples/bwrap.sh
.PHONY: sphinx-html sphinx-texinfo sphinx-info
@@ -161,6 +162,7 @@ $(dir)/config.dox: version.stamp
install-examples:
mkdir -m0755 -p "$(DESTDIR)$(docdir)/examples"
install -m0644 $(EXAMPLES_FILES) $(DESTDIR)$(docdir)/examples
+ install -m0755 $(EXAMPLES_FILES_EXEC) $(DESTDIR)$(docdir)/examples
CLEAN := $(CLEAN) $(DOCBUILDDIR) $(DOCBUILDDIR)/.roff.stamp
$(DOCBUILDDIR)/.texi.stamp
CLEAN := $(CLEAN) $(DOCBUILDDIR)/.html.stamp $(DOCBUILDDIR)/.info.stamp
diff --git a/doc/examples/bwrap.sh b/doc/examples/bwrap.sh
new file mode 100755
index 00000000..04f20fb7
--- /dev/null
+++ b/doc/examples/bwrap.sh
@@ -0,0 +1,9 @@
+#!/bin/sh
+
+# 100MB for /tmp and ~/.cache tmpfs mounts
+TMPSIZE=$((100*1024*1024))
+
+bwrap \
+ --ro-bind / / \
+ --size "$TMPSIZE" --tmpfs /tmp --size "$TMPSIZE" --tmpfs $HOME/.cache \
+ --dev /dev --unshare-all --new-session -- "$@"
diff --git a/doc/man1/notmuch-config.rst b/doc/man1/notmuch-config.rst
index 0418751c..3afea860 100644
--- a/doc/man1/notmuch-config.rst
+++ b/doc/man1/notmuch-config.rst
@@ -172,6 +172,10 @@ paths are presumed relative to `$HOME` for items in section
in ``/usr/share/doc/notmuch``) as ``examples/firejail.profile``. You
may use it as ``notmuch config set index.filter 'firejail
--profile=<.../examples/firejail.profile> <your filter program>'``.
+ * Bubblewrap (https://github.com/containers/bubblewrap , Linux-specific); a
+ sample Bubblewrap invocation is shipped with notmuch documentation as
+ ``examples/bwrap.sh``. You may use it as ``notmuch config set index.filter
+ '.../examples/bwrap.sh <your filter program>'``.
The filter is a commandline split in a POSIX shell-like manner (without
actually invoking the shell, so shell expansions are not performed and shell
--
2.47.3
_______________________________________________
notmuch mailing list -- [email protected]
To unsubscribe send an email to [email protected]
