q-agent1

Usage

Overview

Start an agent to hold secrets. Settings necessary to communicate with the daemon are printed to standard output. These should be captured, and evaluated in your shell, like shown in the synopsis.

Once q-agent is started, the programs listed under "See Also" can be used to store and retrieve secrets.

-c, --csh

output commands compatible with csh-like shells - the default is to print bourne-shell compatible commands

-d, --debug

turn on debugging output, can be used up to two times to generate even more information - level two will output secrets, too, so beware!

-q, --query-options OPTIONS

if a secret is queried on demand, the OPTIONS are passed to the program used to query it. The only viable option right now is --no-global-grab (or -g in short), which prevents grabbing of the keyboard until the query window is focused. (See secret-query(1) for details.)

--fork

fork into the background - this will instruct the agent to act just like a daemon, i.e. it keeps on running, even after you log out.

--help

print a usage synopsis, then exit

--version

print version information, then exit

Environment

AGENT_SOCKET

Other programs will use this variable to find the socket for communicating with the agent. q-agent outputs code to set it to the right value.