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

FreeBSD Manual Pages

  
 
  

home | help
RESOCK(1)		  BSD General Commands Manual		     RESOCK(1)

NAME
     resock -- connect to a usable SSH authentication agent

SYNOPSIS
     resock

DESCRIPTION
     The resock	utility	attempts to connect to an SSH authentication agent by
     looking for its Unix-domain socket	in the /tmp/ssh-* directories.	It
     looks for agent sockets in	a directory owned by the current user and out-
     puts the name of the most recently	created	one in the hope	that it	would
     be	actually active	at the present time.

     The output	of the resock utility is in the	format suitable	for direct use
     by	the eval command of Bourne-like	shells.	 Its main intended purpose is
     to	be able	to easily connect to the new SSH agent socket after reconnect-
     ing to e.g. a screen(1) session on	a remote host, since the environment
     of	the processes running in the screen session will contain an incorrect
     outdated value for	the SSH_AUTH_SOCK environment variable (as it was at
     the time of the creation of the screen session).

RETURN VALUES
     The resock	utility	exits 0	on success, and	>0 if an error occurs.

ENVIRONMENT
     The resock	utility's operation is currently not directly affected by its
     environment.

FILES
     The resock	utility	examines the /tmp/ssh-*	directories and	looks for
     Unix-domain sockets named agent.*.

EXAMPLES
     Set the appropriate environment variables for the currently active	SSH
     agent:

	   eval	`resock`

SEE ALSO
     ssh-add(1)

HISTORY
     The resock	utility	was written by Peter Pentchev in 2010.

AUTHORS
     Peter Penchev <roam@ringlet.net>

BUGS
     *	always looks for the most recent agent socket, which might not really
	be alive (the agent process itself may have been killed	before clean-
	ing up); should	attempt	to actually connect to the agent.

     *	always uses the	output of whoami(1) as the owner of the	agent socket;
	maybe there should be more heuristics (check the validity, try the
	USER or	LOGIN environment variables) or	even an	-u command-line	op-
	tion.

BSD			       October 10, 2013				   BSD

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ENVIRONMENT | FILES | EXAMPLES | SEE ALSO | HISTORY | AUTHORS | BUGS

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

home | help