Browse Source

- resync with today's updates

git-svn-id: https://openser.svn.sourceforge.net/svnroot/openser/trunk@3887 689a6050-402a-0410-94f2-e92a70836424
Daniel-Constantin Mierla 17 years ago
parent
commit
22204e872e
2 changed files with 55 additions and 152 deletions
  1. 38 76
      modules_k/uri_db/README
  2. 17 76
      modules_k/uri_db/doc/uri_db_admin.xml

+ 38 - 76
modules_k/uri_db/README

@@ -33,15 +33,12 @@ Bogdan-Andrei Iancu
         1.3. Exported Parameters
 
               1.3.1. db_url (string)
-              1.3.2. uri_table (string)
-              1.3.3. uri_user_column (string)
-              1.3.4. uri_domain_column (string)
-              1.3.5. uri_uriuser_column (string)
-              1.3.6. subscriber_table (string)
-              1.3.7. subscriber_user_column (string)
-              1.3.8. subscriber_domain_column (string)
-              1.3.9. use_uri_table (integer)
-              1.3.10. use_domain (integer)
+              1.3.2. db_table (string)
+              1.3.3. user_column (string)
+              1.3.4. domain_column (string)
+              1.3.5. uriuser_column (string)
+              1.3.6. use_uri_table (integer)
+              1.3.7. use_domain (integer)
 
         1.4. Exported Functions
 
@@ -55,17 +52,14 @@ Bogdan-Andrei Iancu
 
    1.1. Set db_url parameter
    1.2. Set uri_table parameter
-   1.3. Set uri_user_column parameter
-   1.4. Set uri_domain_column parameter
-   1.5. Set uri_uriuser_column parameter
-   1.6. Set subscriber_table parameter
-   1.7. Set subscriber_user_column parameter
-   1.8. Set subscriber_domain_column parameter
-   1.9. Set use_uri_table parameter
-   1.10. Set use_domain parameter
-   1.11. check_to usage
-   1.12. check_from usage
-   1.13. does_uri_exist usage
+   1.3. Set user_column parameter
+   1.4. Set domain_column parameter
+   1.5. Set uriuser_column parameter
+   1.6. Set use_uri_table parameter
+   1.7. Set use_domain parameter
+   1.8. check_to usage
+   1.9. check_from usage
+   1.10. does_uri_exist usage
 
 Chapter 1. User's Guide
 
@@ -103,96 +97,64 @@ modparam("uri_db", "db_url", "mysql://username:password@localhost/opense
 r")
 ...
 
-1.3.2. uri_table (string)
+1.3.2. db_table (string)
 
-   Table containing list of allowed URIs for each user.
+   The DB table that should be used. Its possible to use the
+   "subscriber" and "uri" table.
 
-   Default value is "uri".
+   Default value is "subscriber".
 
    Example 1.2. Set uri_table parameter
 ...
-modparam("uri_db", "uri_table", "uri")
+modparam("uri_db", "db_table", "uri")
 ...
 
-1.3.3. uri_user_column (string)
+1.3.3. user_column (string)
 
-   Column holding usernames in the URI table.
+   Column holding usernames in the table.
 
    Default value is "username".
 
-   Example 1.3. Set uri_user_column parameter
+   Example 1.3. Set user_column parameter
 ...
-modparam("uri_db", "uri_user_column", "username")
+modparam("uri_db", "user_column", "username")
 ...
 
-1.3.4. uri_domain_column (string)
+1.3.4. domain_column (string)
 
-   Column holding domain in the URI table.
+   Column holding domain in the table.
 
    Default value is "domain".
 
-   Example 1.4. Set uri_domain_column parameter
+   Example 1.4. Set domain_column parameter
 ...
-modparam("uri_db", "uri_domain_column", "domain")
+modparam("uri_db", "domain_column", "domain")
 ...
 
-1.3.5. uri_uriuser_column (string)
+1.3.5. uriuser_column (string)
 
-   Column holding URI username in the URI table.
+   Column holding URI username in the table.
 
    Default value is "uri_user".
 
-   Example 1.5. Set uri_uriuser_column parameter
-...
-modparam("uri_db", "uri_uriuser_column", "uri_user")
-...
-
-1.3.6. subscriber_table (string)
-
-   Name of the subscriber table.
-
-   Default value is "subscriber".
-
-   Example 1.6. Set subscriber_table parameter
-...
-modparam("uri_db", "subscriber_table", "subscriber")
-...
-
-1.3.7. subscriber_user_column (string)
-
-   Column holding username in subscriber table.
-
-   Default value is "username".
-
-   Example 1.7. Set subscriber_user_column parameter
-...
-modparam("uri_db", "subscriber_user_column", "username")
-...
-
-1.3.8. subscriber_domain_column (string)
-
-   Column holding domains in the subscriber table.
-
-   Default value is "domain".
-
-   Example 1.8. Set subscriber_domain_column parameter
+   Example 1.5. Set uriuser_column parameter
 ...
-modparam("uri_db", "subscriber_domain_column", "domain")
+modparam("uri_db", "uriuser_column", "uri_user")
 ...
 
-1.3.9. use_uri_table (integer)
+1.3.6. use_uri_table (integer)
 
    Specify if the "uri" table should be used for checkings instead
    of "subscriber" table. A non-zero value means true.
 
    Default value is "0 (false)".
 
-   Example 1.9. Set use_uri_table parameter
+   Example 1.6. Set use_uri_table parameter
 ...
 modparam("uri_db", "use_uri_table", 1)
 ...
 
-1.3.10. use_domain (integer)
+1.3.7. use_domain (integer)
 
    Specify if the domain part of the URI should be used to
    identify the users (along with username). This is useful in
@@ -204,7 +166,7 @@ modparam("uri_db", "use_uri_table", 1)
 
    Default value is "0 (false)".
 
-   Example 1.10. Set use_domain parameter
+   Example 1.7. Set use_domain parameter
 ...
 modparam("uri_db", "use_domain", 1)
 ...
@@ -218,7 +180,7 @@ modparam("uri_db", "use_domain", 1)
 
    This function can be used from REQUEST_ROUTE.
 
-   Example 1.11. check_to usage
+   Example 1.8. check_to usage
 ...
 if (check_to()) {
         ...
@@ -232,7 +194,7 @@ if (check_to()) {
 
    This function can be used from REQUEST_ROUTE.
 
-   Example 1.12. check_from usage
+   Example 1.9. check_from usage
 ...
 if (check_from()) {
         ...
@@ -249,7 +211,7 @@ if (check_from()) {
 
    This function can be used from REQUEST_ROUTE.
 
-   Example 1.13. does_uri_exist usage
+   Example 1.10. does_uri_exist usage
 ...
 if (does_uri_exist()) {
         ...

+ 17 - 76
modules_k/uri_db/doc/uri_db_admin.xml

@@ -66,29 +66,30 @@ modparam("uri_db", "db_url", "mysql://username:password@localhost/openser")
 	</section>
 
 	<section>
-		<title><varname>uri_table</varname> (string)</title>
+		<title><varname>db_table</varname> (string)</title>
 		<para>
-		Table containing list of allowed &uri;s for each user.
+		The DB table that should be used. Its possible to use the
+		<quote>subscriber</quote> and <quote>uri</quote> table.
 		</para>
 		<para>
 		<emphasis>
-			Default value is <quote>uri</quote>.
+			Default value is <quote>subscriber</quote>.
 		</emphasis>
 		</para>
 		<example>
 		<title>Set <varname>uri_table</varname> parameter</title>
 		<programlisting format="linespecific">
 ...
-modparam("uri_db", "uri_table", "uri")
+modparam("uri_db", "db_table", "uri")
 ...
 </programlisting>
 		</example>
 	</section>
 
 	<section>
-		<title><varname>uri_user_column</varname> (string)</title>
+		<title><varname>user_column</varname> (string)</title>
 		<para>
-		Column holding usernames in the &uri; table.
+		Column holding usernames in the table.
 		</para>
 		<para>
 		<emphasis>
@@ -96,19 +97,19 @@ modparam("uri_db", "uri_table", "uri")
 		</emphasis>
 		</para>
 		<example>
-		<title>Set <varname>uri_user_column</varname> parameter</title>
+		<title>Set <varname>user_column</varname> parameter</title>
 		<programlisting format="linespecific">
 ...
-modparam("uri_db", "uri_user_column", "username")
+modparam("uri_db", "user_column", "username")
 ...
 </programlisting>
 		</example>
 	</section>
 
 	<section>
-		<title><varname>uri_domain_column</varname> (string)</title>
+		<title><varname>domain_column</varname> (string)</title>
 		<para>
-		Column holding domain in the &uri; table.
+		Column holding domain in the table.
 		</para>
 		<para>
 		<emphasis>
@@ -116,19 +117,19 @@ modparam("uri_db", "uri_user_column", "username")
 		</emphasis>
 		</para>
 		<example>
-		<title>Set <varname>uri_domain_column</varname> parameter</title>
+		<title>Set <varname>domain_column</varname> parameter</title>
 		<programlisting format="linespecific">
 ...
-modparam("uri_db", "uri_domain_column", "domain")
+modparam("uri_db", "domain_column", "domain")
 ...
 </programlisting>
 		</example>
 	</section>
 
 	<section>
-		<title><varname>uri_uriuser_column</varname> (string)</title>
+		<title><varname>uriuser_column</varname> (string)</title>
 		<para>
-		Column holding &uri; username in the &uri; table.
+		Column holding &uri; username in the table.
 		</para>
 		<para>
 		<emphasis>
@@ -136,70 +137,10 @@ modparam("uri_db", "uri_domain_column", "domain")
 		</emphasis>
 		</para>
 		<example>
-		<title>Set <varname>uri_uriuser_column</varname> parameter</title>
-		<programlisting format="linespecific">
-...
-modparam("uri_db", "uri_uriuser_column", "uri_user")
-...
-</programlisting>
-		</example>
-	</section>
-
-	<section>
-		<title><varname>subscriber_table</varname> (string)</title>
-		<para>
-		Name of the subscriber table.
-		</para>
-		<para>
-		<emphasis>
-			Default value is <quote>subscriber</quote>.
-		</emphasis>
-		</para>
-		<example>
-		<title>Set <varname>subscriber_table</varname> parameter</title>
-		<programlisting format="linespecific">
-...
-modparam("uri_db", "subscriber_table", "subscriber")
-...
-</programlisting>
-		</example>
-	</section>
-
-	<section>
-		<title><varname>subscriber_user_column</varname> (string)</title>
-		<para>
-		Column holding username in subscriber table.
-		</para>
-		<para>
-		<emphasis>
-			Default value is <quote>username</quote>.
-		</emphasis>
-		</para>
-		<example>
-		<title>Set <varname>subscriber_user_column</varname> parameter</title>
-		<programlisting format="linespecific">
-...
-modparam("uri_db", "subscriber_user_column", "username")
-...
-</programlisting>
-		</example>
-	</section>
-
-	<section>
-		<title><varname>subscriber_domain_column</varname> (string)</title>
-		<para>
-		Column holding domains in the subscriber table.
-		</para>
-		<para>
-		<emphasis>
-			Default value is <quote>domain</quote>.
-		</emphasis>
-		</para>
-		<example>
-		<title>Set <varname>subscriber_domain_column</varname> parameter</title>
+		<title>Set <varname>uriuser_column</varname> parameter</title>
 		<programlisting format="linespecific">
 ...
-modparam("uri_db", "subscriber_domain_column", "domain")
+modparam("uri_db", "uriuser_column", "uri_user")
 ...
 </programlisting>
 		</example>