Gentoo Archives: gentoo-doc-cvs

From: Xavier Neys <neysx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: keychain-guide.xml
Date: Mon, 06 Feb 2006 11:49:43
Message-Id: 200602061149.k16Bn9wn004942@robin.gentoo.org
1 neysx 06/02/06 11:49:33
2
3 Modified: xml/htdocs/doc/en keychain-guide.xml
4 Log:
5 #121732 add KDE instructions
6
7 Revision Changes Path
8 1.2 +53 -5 xml/htdocs/doc/en/keychain-guide.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/keychain-guide.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/keychain-guide.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/keychain-guide.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
13
14 Index: keychain-guide.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/keychain-guide.xml,v
17 retrieving revision 1.1
18 retrieving revision 1.2
19 diff -u -r1.1 -r1.2
20 --- keychain-guide.xml 2 Dec 2004 18:00:28 -0000 1.1
21 +++ keychain-guide.xml 6 Feb 2006 11:49:33 -0000 1.2
22 @@ -1,5 +1,5 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/keychain-guide.xml,v 1.1 2004/12/02 18:00:28 swift Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/keychain-guide.xml,v 1.2 2006/02/06 11:49:33 neysx Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/keychain-guide.xml">
29 @@ -8,6 +8,9 @@
30 <author title="Author">
31 <mail link="airuike@×××××.com">Eric Brown</mail>
32 </author>
33 +<author title="Editor">
34 + <mail link="vanquirius@g.o">Marcelo Góes</mail>
35 +</author>
36
37 <abstract>
38 This document describes how to use ssh shared keys along with the keychain
39 @@ -15,11 +18,11 @@
40 </abstract>
41
42 <!-- The content of this document is licensed under the CC-BY-SA license -->
43 -<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
44 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
45 <license/>
46
47 -<version>1.1</version>
48 -<date>2004-12-02</date>
49 +<version>1.2</version>
50 +<date>2006-02-05</date>
51
52 <chapter>
53 <title>Background</title>
54 @@ -70,7 +73,7 @@
55 </pre>
56
57 <warn>
58 -Be sure to choose a strong passphrase, especially if this key is used for
59 +Be sure to choose a strong passphrase, especially if this key is used for
60 root logons!
61 </warn>
62
63 @@ -263,7 +266,52 @@
64
65 </body>
66 </section>
67 +<section>
68 +<title>Using keychain with KDE</title>
69 +<body>
70 +
71 +<p>
72 +If you are a KDE user, instead of using <path>~/.bash_profile</path>, you can
73 +let KDE manage ssh-agent for you. In order to do so, you will have to edit
74 +<path>/usr/kde/${KDE_VERSION}/env/agent-startup.sh</path>, which is read during
75 +KDE's startup, and
76 +<path>/usr/kde/${KDE_VERSION}/shutdown/agent-shutdown.sh</path>, which is
77 +executed during KDE's shutdown, where ${KDE_VERSION} corresponds to the first
78 +two version components of your KDE installation. For example, if you are using
79 +KDE 3.5.1, here is how you could edit those files:
80 +</p>
81 +
82 +<pre caption="Editing /usr/kde/3.5/env/agent-startup.sh">
83 +if [ -x /usr/bin/ssh-agent ]; then
84 + eval "$(/usr/bin/ssh-agent -s)"
85 +fi
86 +</pre>
87 +
88 +<pre caption="Editing /usr/kde/3.5/shutdown/agent-shutdown.sh">
89 +if [ -n "${SSH_AGENT_PID}" ]; then
90 + eval "$(ssh-agent -k)"
91 +fi
92 +</pre>
93 +
94 +<p>
95 +Now, all you have to do is launch a term of your choice, like Konsole, and load
96 +the keys you would like to use. For example:
97 +</p>
98 +
99 +<pre caption="Loading ssh key">
100 +keychain ~/.ssh/id_dsa
101 +<comment>(Enter your key password)</comment>
102 +</pre>
103 +
104 +<p>
105 +Your keys will be remembered until you end your KDE session or kill the
106 +ssh-agent manually.
107 +</p>
108 +
109 +</body>
110 +</section>
111 </chapter>
112 +
113 <chapter>
114 <title>Concluding remarks</title>
115 <section>
116
117
118
119 --
120 gentoo-doc-cvs@g.o mailing list