~cjwatson/ubuntu/precise/openssh/precise-proposed

« back to all changes in this revision

Viewing changes to ssh-agent.1

  • Committer: Colin Watson
  • Date: 2011-01-24 12:43:25 UTC
  • mfrom: (2660.2.14 gssapi)
  • mto: This revision was merged to the branch mainline in revision 3226.
  • Revision ID: cjwatson@debian.org-20110124124325-lpg368jr1esoeqtt
* New upstream release (http://www.openssh.org/txt/release-5.7):
  - Implement Elliptic Curve Cryptography modes for key exchange (ECDH)
    and host/user keys (ECDSA) as specified by RFC5656.  ECDH and ECDSA
    offer better performance than plain DH and DSA at the same equivalent
    symmetric key length, as well as much shorter keys.
  - sftp(1)/sftp-server(8): add a protocol extension to support a hard
    link operation.  It is available through the "ln" command in the
    client.  The old "ln" behaviour of creating a symlink is available
    using its "-s" option or through the preexisting "symlink" command.
  - scp(1): Add a new -3 option to scp: Copies between two remote hosts
    are transferred through the local host (closes: #508613).
  - ssh(1): "atomically" create the listening mux socket by binding it on
    a temporary name and then linking it into position after listen() has
    succeeded.  This allows the mux clients to determine that the server
    socket is either ready or stale without races (closes: #454784).
    Stale server sockets are now automatically removed (closes: #523250).
  - ssh(1): install a SIGCHLD handler to reap expired child process
    (closes: #594687).
  - ssh(1)/ssh-agent(1): honour $TMPDIR for client xauth and ssh-agent
    temporary directories (closes: #357469, although only if you arrange
    for ssh-agent to actually see $TMPDIR since the setgid bit will cause
    it to be stripped off).

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" $OpenBSD: ssh-agent.1,v 1.50 2010/01/17 21:49:09 tedu Exp $
 
1
.\" $OpenBSD: ssh-agent.1,v 1.53 2010/11/21 01:01:13 djm Exp $
2
2
.\"
3
3
.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
4
4
.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
34
34
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
35
35
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36
36
.\"
37
 
.Dd $Mdocdate: January 17 2010 $
 
37
.Dd $Mdocdate: November 21 2010 $
38
38
.Dt SSH-AGENT 1
39
39
.Os
40
40
.Sh NAME
42
42
.Nd authentication agent
43
43
.Sh SYNOPSIS
44
44
.Nm ssh-agent
45
 
.Op Fl c Li | Fl s
 
45
.Op Fl c | s
46
46
.Op Fl d
47
47
.Op Fl a Ar bind_address
48
48
.Op Fl t Ar life
49
49
.Op Ar command Op Ar arg ...
50
50
.Nm ssh-agent
51
 
.Op Fl c Li | Fl s
 
51
.Op Fl c | s
52
52
.Fl k
53
53
.Sh DESCRIPTION
54
54
.Nm
55
55
is a program to hold private keys used for public key authentication
56
 
(RSA, DSA).
 
56
(RSA, DSA, ECDSA).
57
57
The idea is that
58
58
.Nm
59
59
is started in the beginning of an X-session or a login session, and
72
72
socket
73
73
.Ar bind_address .
74
74
The default is
75
 
.Pa /tmp/ssh-XXXXXXXXXX/agent.\*(Ltppid\*(Gt .
 
75
.Pa $TMPDIR/ssh-XXXXXXXXXX/agent.\*(Ltppid\*(Gt .
76
76
.It Fl c
77
77
Generate C-shell commands on
78
78
.Dv stdout .
114
114
.Xr ssh-add 1
115
115
adds the files
116
116
.Pa ~/.ssh/id_rsa ,
117
 
.Pa ~/.ssh/id_dsa
 
117
.Pa ~/.ssh/id_dsa ,
 
118
.Pa ~/.ssh/id_ecdsa
118
119
and
119
120
.Pa ~/.ssh/identity .
120
121
If the identity has a passphrase,
187
188
Contains the protocol version 1 RSA authentication identity of the user.
188
189
.It Pa ~/.ssh/id_dsa
189
190
Contains the protocol version 2 DSA authentication identity of the user.
 
191
.It Pa ~/.ssh/id_ecdsa
 
192
Contains the protocol version 2 ECDSA authentication identity of the user.
190
193
.It Pa ~/.ssh/id_rsa
191
194
Contains the protocol version 2 RSA authentication identity of the user.
192
 
.It Pa /tmp/ssh-XXXXXXXXXX/agent.\*(Ltppid\*(Gt
 
195
.It Pa $TMPDIR/ssh-XXXXXXXXXX/agent.\*(Ltppid\*(Gt
193
196
.Ux Ns -domain
194
197
sockets used to contain the connection to the authentication agent.
195
198
These sockets should only be readable by the owner.