summaryrefslogtreecommitdiffstats
path: root/tcllib/modules/ftp/docs/fhelp13.html
blob: a6813eafcbce14c257af638974b20e22ec7b1ded (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
<html>
<head>
<title>ftp Library Package 2.1 for Tcl/Tk help file</title>
</head>
<body bgcolor="#ffffff" text="#000000">
<body>

<p>
<dl>
  <dd>
    <p><font face="Arial,Helvetica" color="#526e9c" size="+2"><b>ftp Library Package 2.1 for Tcl/Tk Manual Pages</b></font></p>
  </dd>

  <dd><font face="Arial,Helvetica" size="+1"><b>COMMAND</b></font></dd>
  <dd><dl>  
    <dd><b>ftp::Get</b><em>&nbsp; handle&nbsp; remote &nbsp;?(local | -variable varname)?</em></dd>
    <dd>&nbsp;</dd>
    <dd>

	The <b>ftp::Get</b> command retrieves a remote file <em>remote</em> on the
	ftp server to a local file <em>local</em>. If '-variable varname' is
        specified, then the variable 'varname' will get the retreived data
        stored in it, rather than storing the data in a file.   The file
	parameters passed must contain a fully qualified path name, otherwise
	the command uses the current directory. If local file name is
	unspecified, the remote file name is assigned to the remote file name.
		
	<p>If the file was successfully transferred, then the command
	returns 1, if it fails 0. </p>

    </dd>
  </dl></dd>

  <dd><font face="Arial,Helvetica" size="+1"><b>EXAMPLE</b></font></dd>
  <dd><dl>
    <dd>
	<pre># retrieve unique file name
ftp::Get $conn index.htm

# retrieve different file names
ftp::Get $conn index.htm new.htm

# with different fully qualified path name
if [ftp::Get $conn /incoming/foo.tar.gz /usr/local/src] {
	cd /usr/local/src
	exec gunzip foo.tar.gz
	exec tar xf foo.tar
}
	</pre>
		
    </dd> 
  </dl></dd> 
</dl>
</p>
<p>
[<a href="index.html">Contents</a>]&nbsp;
[<b>Previous:</b> <a href="fhelp125.html">ftp::Append</a>]&nbsp;
[<b>Next:</b> <a href="fhelp14.html">ftp::Reget</a>]
</p>
<p align="left"><hr noshade size="1"><font face="Arial,Helvetica" size="-1">&copy; 1999 <a href="mailto:Steffen.Traeger@t-online.de">Steffen Traeger</a></font></p>
</body>
</html>