Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AGENT-TRANSFER(1)		 User Commands		     AGENT-TRANSFER(1)

NAME
       agent-transfer -	copy a secret key from gpg-agent to ssh-agent

SYNOPSIS
       agent-transfer [options]	KEYGRIP	[COMMENT]

DESCRIPTION
       agent-transfer  extracts	 a  secret  key	from a modern version of GnuPG
       agent and sends it to the running SSH agent.  This is useful for	people
       whose  keys  are	managed	in the long-term by GnuPG's gpg-agent, but who
       prefer the semantics of OpenSSH's ssh-agent for regular use.

       agent-transfer was written as part of the monkeysphere project.

       The KEYGRIP should be specified as a sequence of	20 hexadecimal charac-
       ters.   If  you	aren't sure of the keygrip, you	can inspect the	output
       of:

	       gpg --with-keygrip --list-secret-keys

       The COMMENT is optional,	and will be stored alongside the key  in  ssh-
       agent.	It must	not start with a -, to avoid being mistaken for	an op-
       tion.

OPTIONS
       agent-transfer also accepts options that	would normally	be  passed  to
       ssh-add(1) to constrain the use of the transferred key:

       -c     Indicates	 that  added identities	should be subject to confirma-
	      tion before being	used for authentication.

       -t SECONDS
	      Indicates	that the key should have a lifetime of SECONDS in  the
	      running ssh-agent.

FILES
       ~/.gnupg/S.gpg-agent
	      The  socket where	gpg-agent is listening.	 This is the "standard
	      socket" for modern GnuPG.

ENVIRONMENT VARIABLES
       GNUPGHOME
	      The  GnuPG  home	directory,  where  the	standard  socket   for
	      gpg-agent	 lives.	  If  this  is	not  set,  it is assumed to be
	      ~/.gnupg.

       SSH_AUTH_SOCK
	      Specifies	the location where the running ssh-agent is present.

       Several other environment variables are also passed in some form	to the
       gpg-agent to help it figure out how to run a sensible pinentry, includ-
       ing  GPG_TTY,  TERM,  DISPLAY,  XAUTHORITY,  GTK_IM_MODULE,   DBUS_SES-
       SION_BUS_ADDRESS, and LANG.

AUTHOR
       Written by: Daniel Kahn Gillmor <dkg@fifthhorseman.net>

SEE ALSO
       monkeysphere(7),	ssh(1),	ssh-add(1), ssh-agent(1), gpg(1) gpg-agent(1),

monkeysphere			   May 2016		     AGENT-TRANSFER(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | ENVIRONMENT VARIABLES | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=agent-transfer&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help