<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head profile="http://internetalchemy.org/2003/02/profile">
<link rel="foaf" type="application/rdf+xml" title="FOAF" href="http://www.openlinksw.com/dataspace/uda/about.rdf" />
<link rel="schema.dc" href="http://purl.org/dc/elements/1.1/" />
<meta name="dc.title" content="17. Internet Services" />
<meta name="dc.subject" content="17. Internet Services" />
<meta name="dc.creator" content="OpenLink Software Documentation Team ; " />
<meta name="dc.copyright" content="OpenLink Software, 1999 - 2009" />
<link rel="top" href="index.html" title="OpenLink Virtuoso Universal Server: Documentation" />
<link rel="search" href="/doc/adv_search.vspx" title="Search OpenLink Virtuoso Universal Server: Documentation" />
<link rel="parent" href="internetservices.html" title="Chapter Contents" />
<link rel="prev" href="mime.html" title="MIME & Internet Messages" />
<link rel="next" href="vspguide.html" title="VSP Guide" />
<link rel="shortcut icon" href="../images/misc/favicon.ico" type="image/x-icon" />
<link rel="stylesheet" type="text/css" href="doc.css" />
<link rel="stylesheet" type="text/css" href="/doc/translation.css" />
<title>17. Internet Services</title>
<meta http-equiv="Content-Type" content="text/xhtml; charset=UTF-8" />
<meta name="author" content="OpenLink Software Documentation Team ; " />
<meta name="copyright" content="OpenLink Software, 1999 - 2009" />
<meta name="keywords" content="" />
<meta name="GENERATOR" content="OpenLink XSLT Team" />
</head>
<body>
<div id="header">
<a name="ftpservices" />
<img src="../images/misc/logo.jpg" alt="" />
<h1>17. Internet Services</h1>
</div>
<div id="navbartop">
<div>
<a class="link" href="internetservices.html">Chapter Contents</a> | <a class="link" href="mime.html" title="MIME & Internet Messages">Prev</a> | <a class="link" href="vspguide.html" title="VSP Guide">Next</a>
</div>
</div>
<div id="currenttoc">
<form method="post" action="/doc/adv_search.vspx">
<div class="search">Keyword Search: <br />
<input type="text" name="q" /> <input type="submit" name="go" value="Go" />
</div>
</form>
<div>
<a href="http://www.openlinksw.com/">www.openlinksw.com</a>
</div>
<div>
<a href="http://docs.openlinksw.com/">docs.openlinksw.com</a>
</div>
<br />
<div>
<a href="index.html">Book Home</a>
</div>
<br />
<div>
<a href="contents.html">Contents</a>
</div>
<div>
<a href="preface.html">Preface</a>
</div>
<br />
<div class="selected">
<a href="internetservices.html">Internet Services</a>
</div>
<br />
<div>
<a href="webdavserver.html">WebDAV Server</a>
</div>
<div>
<a href="uriqa.html">URIQA Semantic Web Enabler</a>
</div>
<div>
<a href="maildelivstore.html">Mail Delivery & Storage</a>
</div>
<div>
<a href="nntpnewsgroups.html">NNTP Newsgroups</a>
</div>
<div>
<a href="mime.html">MIME & Internet Messages</a>
</div>
<div class="selected">
<a href="ftpservices.html">FTP Services</a>
<div>
<a href="#ftpservicesclient" title="FTP Client">FTP Client</a>
<a href="#ftpservicesserver" title="FTP Server">FTP Server</a>
</div>
</div>
<div>
<a href="vspguide.html">VSP Guide</a>
</div>
<div>
<a href="ldap.html">LDAP</a>
</div>
<br />
</div>
<div id="text">
<a name="ftpservices" />
<h2>17.6. FTP Services</h2>
<p>Virtuoso provides both FTP client and server functionality. The Virtuoso FTP
client functions allow for programmatic access to ftp servers from Virtuoso/ PL to list, submit and
retrieve files from an FTP server. The Virtuoso FTP server provides FTP access
to the Virtuoso WebDAV repository using the same authentication
and permissions system as WebDAV, and an configurable anonymous
user access.</p>
<a name="ftpservicesclient" />
<h3>17.6.1. FTP Client</h3>
<p>Virtuoso provides three functions that mimic their FTP command
counterparts. These are:</p>
<ul>
<li>
<a href="fn_ftp_get.html">ftp_get()</a> - to retrieve a file from an FTP server.</li>
<li>
<a href="fn_ftp_put.html">ftp_put()</a> - to submit a file to an FTP server.</li>
<li>
<a href="fn_ftp_ls.html">ftp_ls()</a> - list the contents of a directory on an FTP server.</li>
</ul>
<p>The Virtuoso client uses free ports within the range 20000 - 30000 for
active mode connections. This is configurable using the parameters:
<span class="computeroutput">FTPServerMinFreePort</span> and
<span class="computeroutput">FTPServerMaxFreePort</span> in the
<span class="computeroutput">HTTPServer</span> section of the
Virtuoso INI file.</p>
<br />
<a name="ftpservicesserver" />
<h3>17.6.2. FTP Server</h3>
<p>Virtuoso can provide FTP access to its WebDAV repository. This
FTP server functionality relies on the same credentials and permissions that
WebDAV uses. The server is enabled by listing the
<span class="computeroutput">FTPServerPort</span> parameter in the
<span class="computeroutput">HTTPServer</span> section of the Virtuoso INI
file. This parameter must be accompanied by a port number to listen at.</p>
<div>
<pre class="programlisting">
[HTTPServer]
FTPServerPort = 21
</pre>
</div>
<p>Will instruct Virtuoso to listen for FTP requests on the default FTP
port of 21.</p>
<div>
<pre class="programlisting">
[HTTPServer]
...
FTPServerTimeout = 600
...
</pre>
</div>
<p>To control timeout of connections use "FTPServerTimeout" ini parameter.
The default time out is 600 sec. This is only for command connection.</p>
<p>The Virtuoso FTP server can be instructed to create a session log file
using the parameter:</p>
<div>
<pre class="programlisting">
[HTTPServer]
...
FTPServerLogFile = ftpserver
...
</pre>
</div>
<p>If specified Virtuoso will produce an FTP server log file with the date
appended to the name given in the parameter and the files extension as ".log".
The log file is rotated daily. It will contain the following information:</p>
<p>
<span class="computeroutput">ftpserverDDMMYYYY.log</span> :-</p>
<ul>
<li>Client Host Name</li>
<li>Authorized User</li>
<li>Time</li>
<li>User Command</li>
<li>Server Response Code</li>
<li>Bytes Transferred</li>
</ul>
<p>An example of which is:</p>
<div>
<pre class="programlisting">
hostname anonymous [22/Oct/2003:15:21:43 +0300] "PASS user@domain.com" 230 0
hostname anonymous [22/Oct/2003:15:23:11 +0300] "LIST" 226 162
hostname dav [22/Oct/2003:15:25:00 +0300] "PASS <hidden>" 230 0
</pre>
</div>
<p>Virtuoso can allow special "anonymous" user access to the FTP Server
by supplying the following Virtuoso INI file parameter:</p>
<div>
<pre class="programlisting">
[HTTPServer]
...
FTPServerAnonymousLogin = 0
...
</pre>
</div>
<p>The anonymous user is not a real user, it has no SQL or DAV login ability.
The anonymous user can only access collections or resources that are set to public.
The password of the anonymous user is trivially checked to contain the "@" symbol
and is shown in plain-text for the "PASS" command detailed in the log file.
Valid DAV users passwords are never revealed in the FTP log file.
By default anonymous login is denied.</p>
<div>
<pre class="programlisting">
[HTTPServer]
...
FTPServerAnonymousHome = /DAV/dir_name/
...
</pre>
</div>
<p>You can control the anonymous user home dir by "FTPServerAnonymousHome" parameter in the ini fail.
By default home dir for anonymous user is DAV root dir.</p>
<p>The Virtuoso server supports the usual variety of commands such as:</p>
<div>
<pre class="programlisting">
USER PASS CWD CDUP HELP
QUIT PORT PASV TYPE NOOP
STOR RNFR RNTO MODE RETR
DELE RMD MKD PWD SYST
SIZE LIST NLST ABOR
</pre>
</div>
<p>
By default the server uses free ports within the range 20000 - 30000 for passive
mode connections. This is configurable using the parameters:
<span class="computeroutput">FTPServerMinFreePort</span> and
<span class="computeroutput">FTPServerMaxFreePort</span> in the
<span class="computeroutput">HTTPServer</span> section of the
Virtuoso INI file.</p>
<p>The FTP server root directory is the home directory of the authenticated
DAV user.</p>
<div class="tip">
<div class="tiptitle">See Also:</div>
<p>
<a href="http://www.rfc-editor.org/rfc/rfc959.txt">RFC-959</a>
</p>
<p>
<a href="http://www.rfc-editor.org/rfc/rfc2389.txt">RFC-2389</a>
</p>
</div>
<br />
<table border="0" width="90%" id="navbarbottom">
<tr>
<td align="left" width="33%">
<a href="mime.html" title="MIME & Internet Messages">Previous</a>
<br />MIME & Internet Messages</td>
<td align="center" width="34%">
<a href="internetservices.html">Chapter Contents</a>
</td>
<td align="right" width="33%">
<a href="vspguide.html" title="VSP Guide">Next</a>
<br />VSP Guide</td>
</tr>
</table>
</div>
<div id="footer">
<div>Copyright© 1999 - 2009 OpenLink Software All rights reserved.</div>
<div id="validation">
<a href="http://validator.w3.org/check/referer">
<img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" />
</a>
<a href="http://jigsaw.w3.org/css-validator/">
<img src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!" height="31" width="88" />
</a>
</div>
</div>
</body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
71d40963b505df4524269198e237b3e3
>
files
>
767
