[BACK]Return to ssh-agent.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / ssh

Diff for /src/usr.bin/ssh/ssh-agent.1 between version 1.28 and 1.28.2.3

version 1.28, 2001/09/05 06:23:07 version 1.28.2.3, 2002/06/26 18:22:36
Line 42 
Line 42 
 .Nd authentication agent  .Nd authentication agent
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm ssh-agent  .Nm ssh-agent
   .Op Fl a Ar bind_address
 .Op Fl c Li | Fl s  .Op Fl c Li | Fl s
 .Op Fl d  .Op Fl d
 .Op Ar command Op Ar args ...  .Op Ar command Op Ar args ...
Line 64 
Line 65 
 .Pp  .Pp
 The options are as follows:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
   .It Fl a Ar bind_address
   Bind the agent to the unix-domain socket
   .Ar bind_address .
   The default is
   .Pa /tmp/ssh-XXXXXXXX/agent.<ppid> .
 .It Fl c  .It Fl c
 Generate C-shell commands on  Generate C-shell commands on
 .Dv stdout .  .Dv stdout .
Line 94 
Line 100 
 .Xr ssh-add 1 .  .Xr ssh-add 1 .
 When executed without arguments,  When executed without arguments,
 .Xr ssh-add 1  .Xr ssh-add 1
 adds the  adds the files
 .Pa $HOME/.ssh/identity  .Pa $HOME/.ssh/id_rsa ,
 file.  .Pa $HOME/.ssh/id_dsa
   and
   .Pa $HOME/.ssh/identity .
 If the identity has a passphrase,  If the identity has a passphrase,
 .Xr ssh-add 1  .Xr ssh-add 1
 asks for the passphrase (using a small X11 application if running  asks for the passphrase (using a small X11 application if running
Line 127 
Line 135 
 .Xr ssh 1  .Xr ssh 1
 looks at these variables and uses them to establish a connection to the agent.  looks at these variables and uses them to establish a connection to the agent.
 .Pp  .Pp
   The agent will never send a private key over its request channel.
   Instead, operations that require a private key will be performed
   by the agent, and the result will be returned to the requester.
   This way, private keys are not exposed to clients using the agent.
   .Pp
 A unix-domain socket is created  A unix-domain socket is created
 .Pq Pa /tmp/ssh-XXXXXXXX/agent.<pid> ,  
 and the name of this socket is stored in the  and the name of this socket is stored in the
 .Ev SSH_AUTH_SOCK  .Ev SSH_AUTH_SOCK
 environment  environment
Line 139 
Line 151 
 .Pp  .Pp
 The  The
 .Ev SSH_AGENT_PID  .Ev SSH_AGENT_PID
 environment variable holds the agent's PID.  environment variable holds the agent's process ID.
 .Pp  .Pp
 The agent exits automatically when the command given on the command  The agent exits automatically when the command given on the command
 line terminates.  line terminates.
Line 147 
Line 159 
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Pa $HOME/.ssh/identity  .It Pa $HOME/.ssh/identity
 Contains the protocol version 1 RSA authentication identity of the user.  Contains the protocol version 1 RSA authentication identity of the user.
 This file should not be readable by anyone but the user.  
 It is possible to  
 specify a passphrase when generating the key; that passphrase will be  
 used to encrypt the private part of this file.  
 This file is not used by  
 .Nm  
 but is normally added to the agent using  
 .Xr ssh-add 1  
 at login time.  
 .It Pa $HOME/.ssh/id_dsa  .It Pa $HOME/.ssh/id_dsa
 Contains the protocol version 2 DSA authentication identity of the user.  Contains the protocol version 2 DSA authentication identity of the user.
 .It Pa $HOME/.ssh/id_rsa  .It Pa $HOME/.ssh/id_rsa
 Contains the protocol version 2 RSA authentication identity of the user.  Contains the protocol version 2 RSA authentication identity of the user.
 .It Pa /tmp/ssh-XXXXXXXX/agent.<pid>  .It Pa /tmp/ssh-XXXXXXXX/agent.<ppid>
 Unix-domain sockets used to contain the connection to the  Unix-domain sockets used to contain the connection to the
 authentication agent.  authentication agent.
 These sockets should only be readable by the owner.  These sockets should only be readable by the owner.
Legend:
Removed from v.1.28  
changed lines
  Added in v.1.28.2.3