src/main/webapp/jFM.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <title>jFM - java web application file manager</title>
  <link href="styles/style.css" type="text/css" rel="stylesheet">
  <link rel="shortcut icon" href="img/folder.gif" type="image/gif" /> 
  <meta http-equiv="content-type" content="text/html;CHARSET=iso-8859-1">
</head>
<body lang="en">
<h1>jFM<br>
</h1>
<p>jFM is a file manager written as a java web application. It can
be downloaded from <a href="https://github.com/weberjn/jFM">https://github.com/weberjn/jFM</a>.<br>
</p>
<p>jGallery is licensed under the <a href="http://www.gnu.org/">Gnu
Public License</a> (GPL).<br>
</p>
<p>Nevertheless, I'd be happy if you <a href="contact.html#postcard">send
me</a> a
picture postcard of your place.<br>
</p>
<h2>Contents</h2>
<ul>
  <li><a href="#What_you_need">What you need</a></li>
  <li><a href="#Installation">Installation and Configuration</a></li>
  <li><a href="#FindingFolders">Finding Folders</a></li>
  <li><a href="#Security">Security</a></li>
</ul>
<h3><a name="What_you_need"></a>What you need</h3>
<ul>
  <li>a JSP 2.0 compatible web container</li>
</ul>
<h3><a name="Installation">Installation and Configuration<br>
</a></h3>
<p>
</p>
<h4>For Tomcat:<br>
</h4>
<ul>
  <li>drop jFM.war into the Tomcat webapps folder.</li>
</ul>
<h3><a name="FindingFolders">Finding Folders<br>
</a></h3>
<p>
</p>
jFM always displays one folder's contents.<br>
<h4>folder address as real path (path addressing)<br>
</h4>
enter a folder address as real path in the file system<br>
<br>
http://<em>yourhost.com</em>/jFM/<span style="color: rgb(255, 0, 0);">p</span><span
 style="color: rgb(51, 102, 255);">/<em>a/path</em>/</span><br>
<br>
will access<br>
<br>
<span style="color: rgb(255, 0, 0);"></span><span
 style="color: rgb(51, 102, 255);">/<em>a/path</em>/</span><br>
<br>
If context-param filebase in web.xml is set, it will always be
prepended to entered paths. So you can restrict path addressing to a subdirectory of the filesystem.<br>
<br>
e.g. if filebase is <span style="color: rgb(0, 102, 0);">c:/</span><br>
<br>
http://localhost:8080/jFM/<span style="color: rgb(255, 0, 0);">p</span><span
 style="color: rgb(51, 102, 255);">/jakarta-tomcat-5.0.19/webapps/tomcat-docs/<br>
<br>
</span>will access a file system folder <span
 style="color: rgb(0, 102, 0);">c:</span><span
 style="color: rgb(51, 102, 255);">/jakarta-tomcat-5.0.19/</span><span
 style="color: rgb(51, 102, 255);">webapps/tomcat-docs/</span><span
 style="color: rgb(51, 102, 255);"> </span><br>
<br>

<h3><a name="Security">Security</a></h3>
<br>
jFM can be secured with the standard web application security.<br>
<br>
For this, remove the comment around the <em>&lt;security-constraint&gt;</em>
entry in web.xml and only users in role <em>manager </em>will have access.<br>
<br>
If your webmaster insists on running Tomcat with a security manager,
he should add the following entry to
$CATALINA_BASE/conf/catalina.policy<br>
<br>
grant codeBase "file:${catalina.home}/webapps/jFM/WEB-INF/-" {<br>
&nbsp;&nbsp;&nbsp; permission java.io.FilePermission "<span
 style="color: rgb(255, 0, 0);">d:${/}-</span>", "read,write,delete";<br>
&nbsp;&nbsp;&nbsp; permission java.net.SocketPermission "*:80",
"connect";<br>
};<br>
<br>
FilePermission allows access to the filesystem part below the given path <span
 style="color: rgb(255, 0, 0);">p</span>.<br>
<br>
The SocketPermission is needed for the <em>Get file from URL</em>
feature of jFM.
<p class="lastmod">Last modification 2016-05-12</p>
<p class="copyright">Copyright &copy; 2004,2016 <a href="contact.html">J&uuml;rgen
Weber</a></p>
</body>
</html>