path: root/nokeyrings.1

.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.