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

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 confirmation
	    before being used for authentication.

     -t SECONDS
	    Indicates that the key should have a lifetime of SECONDS in the run-
	    ning 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, including
     GPG_TTY, TERM,  DISPLAY,  XAUTHORITY,  GTK_IM_MODULE,  DBUS_SESSION_BUS_AD-
     DRESS, and LANG.

BUGS
     agent-transfer  can only work with RSA and Ed25519 keys.  Support for other
     key types not yet implemented.  Patches welcome!

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			    Jan 2019		       AGENT-TRANSFER(1)

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

home | help