总览 (SYNOPSIS)
ssh-add [-lLdDx ] [-t life ] [file ... ] ssh-add -s reader ssh-add -e reader
描述 (DESCRIPTION)
向认证代理 (authentication agent) , ssh-agent1 , 添加 RSA 或 DSA 身份识别数据. 无参数运行该程序时, 它将 $HOME/.ssh/id_rsa $HOME/.ssh/id_dsa 和 $HOME/.ssh/identity 文件的内容送往认证代理. 可以在命令行上指定不同的文件名. 如果文件需要用密语(passphrase)访问,会提示用户输入, 然后从用户的 tty 终端读取密语. 如果给出多个身份文件,将重试最后一条密语.
要使 正常工作, 必须运行认证代理, 而且是当前进程的祖先.
可用的选项有:
-
-l
- 列出认证代理目前代表的身份的指纹. -L
- 列出认证代理目前代表的身份的公钥参数. -d
- 和添加身份相反, 从认证代理上删除这个身份数据. -D
- 从认证代理上删除所有身份数据. -x
- 用口令锁住代理. -X
- 把代理解锁. -t life
- 向代理添加身份的时候设置最大生命周期. 生命周期以秒为单位, 也可以用 sshd_config5 中规定的时间格式. -c
- 身份在认证前先要被确认. 确认工作由后面提到的 SSH_ASKPASS 程序进行. 确认成功后, SSH_ASKPASS 返回状态字 0 给调用者, 而不用传递文本数据. -s reader
- 添加智能卡 reader 里的密钥. -e reader
- 删除智能卡 reader 里的密钥.
文件 (FILES)
-
$HOME/.ssh/identity
- 内含用户的协议第一版的 RAS 身份数据. $HOME/.ssh/id_dsa
- 内含用户的协议第二版的 DSA 身份数据. $HOME/.ssh/id_rsa
- 内含用户的协议第二版的 RAS 身份数据.
身份文件只许它的用户读取, 其他用户不允许访问. 注意, 如果身份文件能够被其他用户访问, 将忽略这个文件.
环境 (ENVIRONMENT)
-
DISPLAY 和 SSH_ASKPASS
- 如果 需要密语, 当它在终端上运行的时候, 它会从当前终端上读取这个密语. 如果 没有和终端关联, 但是设置了 DISPLAY 和 SSH_ASKPASS 环境变量, 它就执行 SSH_ASKPASS 指定的程序, 打开一个 X11 窗口读取密语. 从 .Xsession 或类似的描述文件调用 时, 这个功能非常有用. (注意, 某些机器上可能先要把输入重定向到 /dev/null 才能工作.) SSH_AUTH_SOCK
- 标明一个 UNIX 域 socket 的路径, 用于和代理通信.