110 lines
7.2 KiB
HTML
110 lines
7.2 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="topic" />
|
|
<meta name="DC.Title" content="Module mod_userdir" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2002,2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002,2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rzaiemod_userdir" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Module mod_userdir</title>
|
|
</head>
|
|
<body id="rzaiemod_userdir"><a name="rzaiemod_userdir"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<!--Java sync-link--><h1 class="topictitle1">Module mod_userdir</h1>
|
|
<div><div class="important"><span class="importanttitle">Important:</span> Information
|
|
for this topic supports the latest PTF levels for HTTP Server for i5/OS .
|
|
It is recommended that you install the latest PTFs to upgrade to the latest
|
|
level of the HTTP Server for i5/OS. Some of the topics documented here are
|
|
not available prior to this update. See <a href="http://www-03.ibm.com/servers/eserver/iseries/software/http/services/service.html" target="_blank">http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm</a> <img src="www.gif" alt="Link outside Information Center" /> for more information. </div>
|
|
<p><strong>Summary</strong></p>
|
|
<p>The module mod_userdir provides for user-specific directories. </p>
|
|
<p><strong>Directive</strong></p>
|
|
<ul><li><a href="#userdir">UserDir</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="hr" id="userdir"><a name="userdir"><!-- --></a><h2 class="topictitle2">UserDir </h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_userdir </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: UserDir <em>directory [directory ...] | enabled
|
|
username [username ...] | disabled [username...]</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: UserDir public_html </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="userdir__userdir_context"><a name="userdir__userdir_context"><!-- --></a>server config,
|
|
virtual host </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: mod_userdir </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="userdir__userdir_origin"><a name="userdir__userdir_origin"><!-- --></a>Apache </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: UserDir WWW </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: UserDir enable lewis thomas </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: UserDir disable sherman fazio</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: UserDir disable</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The UserDir directive sets the real directory in a user's home directory
|
|
to use when a request for a document for a user is received. The user's home
|
|
directory is based on the HOMEDIR setting of the user's iSeries™ user
|
|
profile. Directory is one of the following: </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>directory </em></dt>
|
|
<dd><ul><li>The name of a directory or a pattern such as those shown below. </li>
|
|
<li>The keyword <em>disabled</em>. This turns off all username-to-directory
|
|
translations except those explicitly named with the enabled keyword (see below).
|
|
</li>
|
|
<li>The keyword <em>disabled</em> followed by a space-delimited list of usernames.
|
|
Usernames that appear in such a list will never have directory translation
|
|
performed, even if they appear in an enabled clause. </li>
|
|
<li>The keyword <em>enabled</em> followed by a space-delimited list of usernames.
|
|
These usernames will have directory translation performed even if a global
|
|
disable is in effect, but not if they also appear in a disabled clause. Note:
|
|
the keyword enabled without a list of usernames is not valid. </li>
|
|
</ul>
|
|
<div class="note"><span class="notetitle">Note:</span> The UserDir directive is not inherited by virtual hosts when it
|
|
is set in the global server configuration. </div>
|
|
</dd>
|
|
</dl>
|
|
<p>If neither the enabled nor the disabled keywords appear in the UserDir
|
|
directive, the argument is treated as a filename pattern (or list of filename
|
|
patterns), and is used to turn the name into a directory specification. For
|
|
example, assume that the HOMEDIR parameter of the iSeries user profile "bob" is set to <tt>/home/bob</tt>.
|
|
A request for <tt>http://www.QIBM.com/~bob/one/two.html</tt> will be translated
|
|
to: </p>
|
|
<pre class="block">UserDir public_html -> /home/bob/public_html/one/two.html
|
|
UserDir /usr/web -> /usr/web/bob/one/two.html
|
|
UserDir /home/*/www -> /home/bob/www/one/two.html</pre>
|
|
<p>The following directives will send redirects to the client: </p>
|
|
<pre class="block">UserDir http://www.QIBM.com/users -> http://www.QIBM.com/users/home/bob/one/two.html
|
|
UserDir http://www.QIBM.com/*/usr -> http://www.QIBM.com/home/bob/usr/one/two.html</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> Use caution when using this directive; for instance, "<tt>UserDir ./</tt>"
|
|
would map "<tt>/~root" to "/</tt>" - which is most likely undesirable. It
|
|
is strongly recommended that your configuration include a "<tt>UserDir disabled
|
|
root</tt>" declaration. If multiple UserDir directives without disable or
|
|
enable keywords occur in a configuration, the last one is used.</div>
|
|
<p>See <Directory> and <a href="rzaiesecuritytips.htm">Security tips for HTTP Server</a> for
|
|
more information.</p>
|
|
</div>
|
|
</div>
|
|
|
|
</body>
|
|
</html> |