First commit

Signed-off-by: Mattias Andrée <m@maandree.se>

1 files changed, 96 insertions, 0 deletions

diff --git a/nokeyrings.1 b/nokeyrings.1
new file mode 100644
index 0000000..984b7d8
--- /dev/null
+++ b/nokeyrings.1
@@ -0,0 +1,96 @@
+.TH NOKEYRINGS 1 NOKEYRINGS
+.SH NAME
+nokeyrings - Spawn a new program and hide the user's keyrings from it
+
+.SH SYNOPSIS
+.B nokeyrings
+.I utility
+.RI [ argument "] ..."
+
+.SH DESCRIPTION
+The
+.B nokeyrings
+utility runs a specified
+.IR utility ,
+but mounts
+.I /var/empty
+over
+.IR ~/.local/share/keyrings ,
+if both directories exist, (failure is ignored)
+for that process and its children, effectively
+hiding the user's keyrings.
+
+.SH OPTIONS
+No options are supported.
+
+.SH OPERANDS
+The following operands are supported:
+.TP
+.I utility
+The name of the utility to be invoked.
+.TP
+.I argument
+A string to pass as an argument for the invoked utility.
+
+.SH STDIN
+Not used.
+
+.SH INPUT FILES
+None.
+
+.SH ENVIRONMENT VARIABLES
+The following environment variables affect
+the execution of
+.BR nokeyrings :
+.TP
+.B PATH
+Determine the location of the
+.IR utility ,
+as described in the Base Definitions volume of POSIX.1‐2017,
+.IR "Chapter 8, Environment Variables" .
+
+.SH STDOUT
+Not used.
+
+.SH STDERR
+The standard error is be used only for diagnostic messages.
+
+.SH OUTPUT FILES
+None.
+
+.SJ EXIT STATUS
+If
+.I utility
+is invoked, the exit status of
+.B nokeyrings
+is the exit status of
+.IR utility ;
+otherwise, the
+.B nokeyrings
+utility exits with one of the following values:
+.TP
+125
+An error occurred in the
+.B nokeyrings
+utility.
+.TP
+126
+The utility specified by
+.I utility
+was found but could not be invoked.
+.TP
+127
+The utility sspecified by
+.I utility
+could not be found.
+
+.SH RATIONALE
+The
+.B nokeyrings
+utility can be used as a wrapper around programs
+that nags the user about entering his password to access a
+keyring, if he does it use it but the keyring is tightly
+integrated into the OS distribution and cannot easily be removed.
+
+.SH SEE ALSO
+None.