1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" |
2 |
"http://www.w3.org/TR/html4/strict.dtd"> |
"http://www.w3.org/TR/html4/strict.dtd"> |
3 |
<html> |
<html> |
4 |
<head> |
<head> |
5 |
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
6 |
<title>getpassword</title> |
<title>getpassword</title> |
7 |
<meta http-equiv="Content-Style-Type" content="text/css"> |
<meta http-equiv="Content-Style-Type" content="text/css"> |
8 |
<link rel="stylesheet" href="../../style.css" type="text/css"> |
<link rel="stylesheet" href="../../style.css" type="text/css"> |
9 |
</head> |
</head> |
10 |
|
|
11 |
<body> |
<body> |
12 |
|
|
13 |
|
|
14 |
<h1>getpassword</h1> |
<h1>getpassword</h1> |
15 |
|
|
16 |
<p> |
<p> |
17 |
Reads a password. |
Reads a password. |
18 |
</p> |
</p> |
19 |
|
|
20 |
<h2>Format</h2> |
<h2>Format</h2> |
21 |
|
|
22 |
<pre class="macro-syntax"> |
<pre class="macro-syntax"> |
23 |
getpassword <filename> <password name> <strvar> |
getpassword <filename> <password name> <strvar> |
24 |
</pre> |
</pre> |
25 |
|
|
26 |
<h2>Remarks</h2> |
<h2>Remarks</h2> |
27 |
|
|
28 |
<p> |
<p> |
29 |
Retrieves an encrypted password identified by <password name> from the password file <filename>.<br> |
Retrieves an encrypted password identified by <password name> from the password file <filename>.<br> |
30 |
Decrypts the password and stores it into the string variable <strvar>. |
Decrypts the password and stores it into the string variable <strvar>. |
31 |
</p> |
</p> |
32 |
|
|
33 |
<p> |
<p> |
34 |
If the specified file does not exist, it is newly created.<br> |
If the specified file does not exist, it is newly created.<br> |
35 |
If the specified password is not stored in the file, the password dialog box appears and the entered password is stored in <strvar>.<br> |
If the specified password is not stored in the file, the password dialog box appears and the entered password is stored in <strvar>.<br> |
36 |
At the same time, the new password is encrypted and written in the file with the identifier <password name>. |
At the same time, the new password is encrypted and written in the file with the identifier <password name>. |
37 |
</p> |
</p> |
38 |
|
|
39 |
<p> |
<p> |
40 |
A password file can contain multiple passwords.<br> |
A password file can contain multiple passwords.<br> |
41 |
Each of them is identified by the password identifier. |
Each of them is identified by the password identifier. |
42 |
</p> |
</p> |
43 |
|
|
44 |
<h2>Example</h2> |
<h2>Example</h2> |
45 |
|
|
46 |
<pre class="macro-example"> |
<pre class="macro-example"> |
47 |
<strong>getpassword</strong> 'password.dat' 'mypassword' password |
<strong>getpassword</strong> 'password.dat' 'mypassword' password |
48 |
connect 'myhost' |
connect 'myhost' |
49 |
wait 'login:' |
wait 'login:' |
50 |
sendln 'myname' |
sendln 'myname' |
51 |
wait 'password:' |
wait 'password:' |
52 |
sendln password |
sendln password |
53 |
</pre> |
</pre> |
54 |
|
|
55 |
</BODY> |
</BODY> |
56 |
</HTML> |
</HTML> |