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

FreeBSD Manual Pages

  
 
  

home | help
ssh-multiadd(1)		    General Commands Manual	       ssh-multiadd(1)

NAME
       ssh-multiadd - ssh-add multiple ssh keys	with the same passphrase(s) to
       ssh-agent

SYNOPSIS
       ssh-multiadd [opts] [keyfiles]

DESCRIPTION
       Add  multiple  ssh  keys	that may use the same passphrase(s) to the ssh
       authentication  agent.	 When	run   without	arguments,   it	  adds
       $HOME/.ssh/identity  and	$HOME/.ssh/id_dsa.  Alternative	file names can
       be given	on the command line or specified in  the  configuration	 file.
       Uses  ssh-askpass  if  necessary.   The	files  need  not  use the same
       passphrase, ssh-multiadd	will try all entered  passwords	 against  each
       key,  so	 any  number  of  keys may share passphrases without having to
       reenter them.

OPTIONS
       -a auto|yes|no
	      Specifies	when to	use ssh-askpass	 program  instead  of  reading
	      from terminal.  auto (the	default) means to only use ssh-askpass
	      when  stdin  is  not a tty.  yes always uses ssh-askpass,	and no
	      never does.

       -A <path>
	      Program to use instead of	ssh-askpass.

       -s <path>
	      Program to use instead of	ssh-add.

       -S <path>
	      Program to use instead of	ssh.

       -d <path>
	      Directory	to look	for keyfiles that  do  not  have  an  absolute
	      path.

       -f     Force  all  keys	to  be	added, don't check if they are already
	      loaded.  (equivalent to sshgetfingerprint=None in	rc file)

       -l     When done, call "ssh-add -l" to list all identities  represented
	      by the agent.

       -L     Before  and after	running, call "ssh-add -l", then lists differ-
	      ences in represented identities.

       --nolist
	      Don't list any identities	when done.  In other words, disable -l
	      or -L.

       -h/--help
	      Print help info.

       --version
	      Print unadorned version.

       --debug
	      Enable printing of debug messages.  Note that it is possible  in
	      some circumstances that passphrases may appear in	the output, so
	      exercise caution if using	this option.

CONFIGURATION
       The file	~/.ssh-multiadd.rc.py may be created to	change the default op-
       tions.	The following are the recognized variables (and	what option(s)
       they correspond to):

       keys   A	list (or tuple)	of files to add	if none	are specified  on  the
	      command line.
	      ex: keys = ('identity', 'identity2', 'id_dsa')

       ssh (-S)
	      A	string containing the path to the ssh executable. (Used	to get
	      ssh  version  for	 setting sshgetfingerprint if it is not	speci-
	      fied)
	      ex: ssh =	'/usr/local/bin/ssh'

       sshadd (-a)
	      A	string containing the path to the ssh-add executable.
	      ex: sshadd = '/usr/local/bin/ssh-add'

       sshaskpass (-A)
	      A	string containing the path to the ssh-askpass executable.
	      ex: sshaskpass = '/usr/local/bin/x11-ssh-askpass'

       sshdir (-d)
	      A	string containing the path to the dir in which to look for key
	      files.
	      ex: sshdir = os.path.expanduser('~/.ssh2')

       sshgetfingerprint
	      A	tuple containing (command to print fingerprint,	regex  to  ex-
	      tract finger print from output).	If not specified or set	to -1,
	      the version from ssh -V will be checked and known	values will be
	      used.  Set to None to disable fingerprint	checking.
	      ex:  sshgetfingerprint  =	 ('/usr/bin/ssh-keygen	-l  -f	"%s"',
	      '(\S+\s+\S+)')

       useaskpass (-a)
	      A	string,	either 'yes', 'no', or 'auto'.
	      ex: useaskpass = 'no'

       verbose (--debug)
	      An int specifying	verbosity level.
	      ex: verbose = 1

       listidentities (-l, -L, --nolist)
	      An int specifying	whether	to list	identities at  exit.  (0=--no-
	      list, 1=-l, 2=-L)
	      ex: listidentities = 2

FILES
       $HOME/.ssh/identity and $HOME/.ssh/id_dsa
	      Default key files	to add.

       $HOME/.ssh-multiadd.rc.py
	      Optional configuration file.

ENVIRONMENT
       SSH_ASKPASS
	      If  specified and	not overridden with -A,	program	to use instead
	      of ssh-askpass.

AUTHOR
       Matthew Mueller <donut@azstarnet.com>

       The latest version, and other programs I	have  written,	are  available
       from:
       http://www.azstarnet.com/~donut/programs/

SEE ALSO
       ssh-add(1), ssh-agent(1), ssh(1), ssh-keygen(1)

				  13 Apr 2001		       ssh-multiadd(1)

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

home | help