1999-10-29 03:15:49 +04:00
|
|
|
.\" -*- nroff -*-
|
|
|
|
.\"
|
|
|
|
.\" ssh-add.1
|
|
|
|
.\"
|
|
|
|
.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
|
|
|
|
.\"
|
|
|
|
.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
|
|
|
|
.\" All rights reserved
|
|
|
|
.\"
|
|
|
|
.\" Created: Sat Apr 22 23:55:14 1995 ylo
|
|
|
|
.\"
|
- Remove references to SSLeay.
- Big OpenBSD CVS update
- markus@cvs.openbsd.org
[clientloop.c]
- typo
[session.c]
- update proctitle on pty alloc/dealloc, e.g. w/ windows client
[session.c]
- update proctitle for proto 1, too
[channels.h nchan.c serverloop.c session.c sshd.c]
- use c-style comments
- deraadt@cvs.openbsd.org
[scp.c]
- more atomicio
- markus@cvs.openbsd.org
[channels.c]
- set O_NONBLOCK
[ssh.1]
- update AUTHOR
[readconf.c ssh-keygen.c ssh.h]
- default DSA key file ~/.ssh/id_dsa
[clientloop.c]
- typo, rm verbose debug
- deraadt@cvs.openbsd.org
[ssh-keygen.1]
- document DSA use of ssh-keygen
[sshd.8]
- a start at describing what i understand of the DSA side
[ssh-keygen.1]
- document -X and -x
[ssh-keygen.c]
- simplify usage
- markus@cvs.openbsd.org
[sshd.8]
- there is no rhosts_dsa
[ssh-keygen.1]
- document -y, update -X,-x
[nchan.c]
- fix close for non-open ssh1 channels
[servconf.c servconf.h ssh.h sshd.8 sshd.c ]
- s/DsaKey/HostDSAKey/, document option
[sshconnect2.c]
- respect number_of_password_prompts
[channels.c channels.h servconf.c servconf.h session.c sshd.8]
- GatewayPorts for sshd, ok deraadt@
[ssh-add.1 ssh-agent.1 ssh.1]
- more doc on: DSA, id_dsa, known_hosts2, authorized_keys2
[ssh.1]
- more info on proto 2
[sshd.8]
- sync AUTHOR w/ ssh.1
[key.c key.h sshconnect.c]
- print key type when talking about host keys
[packet.c]
- clear padding in ssh2
[dsa.c key.c radix.c ssh.h sshconnect1.c uuencode.c uuencode.h]
- replace broken uuencode w/ libc b64_ntop
[auth2.c]
- log failure before sending the reply
[key.c radix.c uuencode.c]
- remote trailing comments before calling __b64_pton
[auth2.c readconf.c readconf.h servconf.c servconf.h ssh.1]
[sshconnect2.c sshd.8]
- add DSAAuthetication option to ssh/sshd, document SSH2 in sshd.8
- Bring in b64_ntop and b64_pton from OpenBSD libc (bsd-base64.[ch])
2000-05-07 06:03:14 +04:00
|
|
|
.\" $Id: ssh-add.1,v 1.13 2000/05/07 02:03:18 damien Exp $
|
1999-10-29 03:15:49 +04:00
|
|
|
.\"
|
|
|
|
.Dd September 25, 1999
|
|
|
|
.Dt SSH-ADD 1
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm ssh-add
|
- Remove references to SSLeay.
- Big OpenBSD CVS update
- markus@cvs.openbsd.org
[clientloop.c]
- typo
[session.c]
- update proctitle on pty alloc/dealloc, e.g. w/ windows client
[session.c]
- update proctitle for proto 1, too
[channels.h nchan.c serverloop.c session.c sshd.c]
- use c-style comments
- deraadt@cvs.openbsd.org
[scp.c]
- more atomicio
- markus@cvs.openbsd.org
[channels.c]
- set O_NONBLOCK
[ssh.1]
- update AUTHOR
[readconf.c ssh-keygen.c ssh.h]
- default DSA key file ~/.ssh/id_dsa
[clientloop.c]
- typo, rm verbose debug
- deraadt@cvs.openbsd.org
[ssh-keygen.1]
- document DSA use of ssh-keygen
[sshd.8]
- a start at describing what i understand of the DSA side
[ssh-keygen.1]
- document -X and -x
[ssh-keygen.c]
- simplify usage
- markus@cvs.openbsd.org
[sshd.8]
- there is no rhosts_dsa
[ssh-keygen.1]
- document -y, update -X,-x
[nchan.c]
- fix close for non-open ssh1 channels
[servconf.c servconf.h ssh.h sshd.8 sshd.c ]
- s/DsaKey/HostDSAKey/, document option
[sshconnect2.c]
- respect number_of_password_prompts
[channels.c channels.h servconf.c servconf.h session.c sshd.8]
- GatewayPorts for sshd, ok deraadt@
[ssh-add.1 ssh-agent.1 ssh.1]
- more doc on: DSA, id_dsa, known_hosts2, authorized_keys2
[ssh.1]
- more info on proto 2
[sshd.8]
- sync AUTHOR w/ ssh.1
[key.c key.h sshconnect.c]
- print key type when talking about host keys
[packet.c]
- clear padding in ssh2
[dsa.c key.c radix.c ssh.h sshconnect1.c uuencode.c uuencode.h]
- replace broken uuencode w/ libc b64_ntop
[auth2.c]
- log failure before sending the reply
[key.c radix.c uuencode.c]
- remote trailing comments before calling __b64_pton
[auth2.c readconf.c readconf.h servconf.c servconf.h ssh.1]
[sshconnect2.c sshd.8]
- add DSAAuthetication option to ssh/sshd, document SSH2 in sshd.8
- Bring in b64_ntop and b64_pton from OpenBSD libc (bsd-base64.[ch])
2000-05-07 06:03:14 +04:00
|
|
|
.Nd adds RSA identities for the authentication agent
|
1999-10-29 03:15:49 +04:00
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm ssh-add
|
1999-11-17 09:29:08 +03:00
|
|
|
.Op Fl lLdD
|
1999-10-29 03:15:49 +04:00
|
|
|
.Op Ar
|
2000-04-13 06:26:34 +04:00
|
|
|
.Sh DESCRIPTION
|
1999-10-29 03:15:49 +04:00
|
|
|
.Nm
|
- Remove references to SSLeay.
- Big OpenBSD CVS update
- markus@cvs.openbsd.org
[clientloop.c]
- typo
[session.c]
- update proctitle on pty alloc/dealloc, e.g. w/ windows client
[session.c]
- update proctitle for proto 1, too
[channels.h nchan.c serverloop.c session.c sshd.c]
- use c-style comments
- deraadt@cvs.openbsd.org
[scp.c]
- more atomicio
- markus@cvs.openbsd.org
[channels.c]
- set O_NONBLOCK
[ssh.1]
- update AUTHOR
[readconf.c ssh-keygen.c ssh.h]
- default DSA key file ~/.ssh/id_dsa
[clientloop.c]
- typo, rm verbose debug
- deraadt@cvs.openbsd.org
[ssh-keygen.1]
- document DSA use of ssh-keygen
[sshd.8]
- a start at describing what i understand of the DSA side
[ssh-keygen.1]
- document -X and -x
[ssh-keygen.c]
- simplify usage
- markus@cvs.openbsd.org
[sshd.8]
- there is no rhosts_dsa
[ssh-keygen.1]
- document -y, update -X,-x
[nchan.c]
- fix close for non-open ssh1 channels
[servconf.c servconf.h ssh.h sshd.8 sshd.c ]
- s/DsaKey/HostDSAKey/, document option
[sshconnect2.c]
- respect number_of_password_prompts
[channels.c channels.h servconf.c servconf.h session.c sshd.8]
- GatewayPorts for sshd, ok deraadt@
[ssh-add.1 ssh-agent.1 ssh.1]
- more doc on: DSA, id_dsa, known_hosts2, authorized_keys2
[ssh.1]
- more info on proto 2
[sshd.8]
- sync AUTHOR w/ ssh.1
[key.c key.h sshconnect.c]
- print key type when talking about host keys
[packet.c]
- clear padding in ssh2
[dsa.c key.c radix.c ssh.h sshconnect1.c uuencode.c uuencode.h]
- replace broken uuencode w/ libc b64_ntop
[auth2.c]
- log failure before sending the reply
[key.c radix.c uuencode.c]
- remote trailing comments before calling __b64_pton
[auth2.c readconf.c readconf.h servconf.c servconf.h ssh.1]
[sshconnect2.c sshd.8]
- add DSAAuthetication option to ssh/sshd, document SSH2 in sshd.8
- Bring in b64_ntop and b64_pton from OpenBSD libc (bsd-base64.[ch])
2000-05-07 06:03:14 +04:00
|
|
|
adds RSA identities to the authentication agent,
|
1999-10-29 03:15:49 +04:00
|
|
|
.Xr ssh-agent 1 .
|
|
|
|
When run without arguments, it adds the file
|
|
|
|
.Pa $HOME/.ssh/identity .
|
2000-03-26 07:04:51 +04:00
|
|
|
Alternative file names can be given on the command line.
|
|
|
|
If any file requires a passphrase,
|
1999-10-29 03:15:49 +04:00
|
|
|
.Nm
|
2000-04-13 06:26:34 +04:00
|
|
|
asks for the passphrase from the user.
|
2000-03-26 07:04:51 +04:00
|
|
|
The Passphrase it is read from the user's tty.
|
1999-10-29 03:15:49 +04:00
|
|
|
.Pp
|
|
|
|
The authentication agent must be running and must be an ancestor of
|
|
|
|
the current process for
|
|
|
|
.Nm
|
|
|
|
to work.
|
|
|
|
.Pp
|
|
|
|
The options are as follows:
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
.It Fl l
|
1999-11-17 09:29:08 +03:00
|
|
|
Lists fingerprints of all identities currently represented by the agent.
|
|
|
|
.It Fl L
|
|
|
|
Lists public key parameters of all identities currently represented by the agent.
|
1999-10-29 03:15:49 +04:00
|
|
|
.It Fl d
|
|
|
|
Instead of adding the identity, removes the identity from the agent.
|
|
|
|
.It Fl D
|
|
|
|
Deletes all identities from the agent.
|
|
|
|
.El
|
|
|
|
.Sh FILES
|
|
|
|
.Bl -tag -width Ds
|
1999-12-06 03:47:28 +03:00
|
|
|
.It Pa $HOME/.ssh/identity
|
2000-03-26 07:04:51 +04:00
|
|
|
Contains the RSA authentication identity of the user.
|
|
|
|
This file should not be readable by anyone but the user.
|
1999-10-29 03:15:49 +04:00
|
|
|
Note that
|
|
|
|
.Nm
|
|
|
|
ignores this file if it is accessible by others.
|
|
|
|
It is possible to
|
|
|
|
specify a passphrase when generating the key; that passphrase will be
|
2000-03-26 07:04:51 +04:00
|
|
|
used to encrypt the private part of this file.
|
|
|
|
This is the default file added by
|
1999-10-29 03:15:49 +04:00
|
|
|
.Nm
|
|
|
|
when no other files have been specified.
|
|
|
|
.Pp
|
1999-12-06 03:47:28 +03:00
|
|
|
.Sh ENVIRONMENT
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
.It Ev "DISPLAY" and "SSH_ASKPASS"
|
1999-10-29 03:15:49 +04:00
|
|
|
If
|
|
|
|
.Nm
|
|
|
|
needs a passphrase, it will read the passphrase from the current
|
2000-03-26 07:04:51 +04:00
|
|
|
terminal if it was run from a terminal.
|
|
|
|
If
|
1999-10-29 03:15:49 +04:00
|
|
|
.Nm
|
|
|
|
does not have a terminal associated with it but
|
|
|
|
.Ev DISPLAY
|
1999-11-25 03:54:57 +03:00
|
|
|
and
|
|
|
|
.Ev SSH_ASKPASS
|
|
|
|
are set, it will execute the program specified by
|
|
|
|
.Ev SSH_ASKPASS
|
2000-03-26 07:04:51 +04:00
|
|
|
and open an X11 window to read the passphrase.
|
|
|
|
This is particularly useful when calling
|
1999-10-29 03:15:49 +04:00
|
|
|
.Nm
|
|
|
|
from a
|
|
|
|
.Pa .Xsession
|
2000-03-26 07:04:51 +04:00
|
|
|
or related script.
|
|
|
|
(Note that on some machines it
|
1999-10-29 03:15:49 +04:00
|
|
|
may be necessary to redirect the input from
|
|
|
|
.Pa /dev/null
|
|
|
|
to make this work.)
|
|
|
|
.Sh AUTHOR
|
|
|
|
Tatu Ylonen <ylo@cs.hut.fi>
|
|
|
|
.Pp
|
|
|
|
OpenSSH
|
|
|
|
is a derivative of the original (free) ssh 1.2.12 release, but with bugs
|
2000-03-26 07:04:51 +04:00
|
|
|
removed and newer features re-added.
|
|
|
|
Rapidly after the 1.2.12 release,
|
|
|
|
newer versions bore successively more restrictive licenses.
|
|
|
|
This version of OpenSSH
|
1999-10-29 03:15:49 +04:00
|
|
|
.Bl -bullet
|
|
|
|
.It
|
2000-04-20 17:27:27 +04:00
|
|
|
has all components of a restrictive nature (i.e., patents)
|
1999-10-29 03:15:49 +04:00
|
|
|
directly removed from the source code; any licensed or patented components
|
|
|
|
are chosen from
|
|
|
|
external libraries.
|
|
|
|
.It
|
|
|
|
has been updated to support ssh protocol 1.5.
|
|
|
|
.It
|
2000-04-13 06:26:34 +04:00
|
|
|
contains added support for
|
1999-10-29 03:15:49 +04:00
|
|
|
.Xr kerberos 8
|
|
|
|
authentication and ticket passing.
|
|
|
|
.It
|
|
|
|
supports one-time password authentication with
|
|
|
|
.Xr skey 1 .
|
|
|
|
.El
|
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr ssh 1 ,
|
|
|
|
.Xr ssh-agent 1 ,
|
|
|
|
.Xr ssh-keygen 1 ,
|
|
|
|
.Xr sshd 8 ,
|