Roxen.git / server / base_server / module.pike

version» Context lines:

Roxen.git/server/base_server/module.pike:1:   // This file is part of Roxen WebServer.   // Copyright © 1996 - 2004, Roxen IS. - // $Id: module.pike,v 1.223 2006/01/12 00:03:10 mast Exp $ + // $Id: module.pike,v 1.224 2006/04/20 13:31:53 grubba Exp $      #include <module_constants.h>   #include <module.h>   #include <request_trace.h>      constant __pragma_save_parent__ = 1;      inherit "basic_defvar";   mapping(string:array(int)) error_log=([]);   
Roxen.git/server/base_server/module.pike:849:   //!   //! @returns   //! The valid return values are:   //! @mixed   //! @type DAVLock   //! The lock owned by the authenticated user that apply to   //! @[path]. (It doesn't matter if the @expr{recursive@} flag in   //! the lock doesn't match the @[recursive] argument.)   //! @type LockFlag   //! @int - //! @value LOCK_NONE (0) - //! No locks apply. - //! @value LOCK_SHARED_BELOW (2) + //! @value LOCK_NONE + //! No locks apply. (0) + //! @value LOCK_SHARED_BELOW   //! There are only one or more shared locks held by other   //! users somewhere below @[path] (but not on @[path] - //! itself). Only returned if @[recursive] is set. - //! @value LOCK_SHARED_AT (3) + //! itself). Only returned if @[recursive] is set. (2) + //! @value LOCK_SHARED_AT   //! There are only one or more shared locks held by other - //! users on @[path]. - //! @value LOCK_OWN_BELOW (4) + //! users on @[path]. (3) + //! @value LOCK_OWN_BELOW   //! The authenticated user has locks under @[path] (but not   //! on @[path] itself) and there are no exclusive locks held - //! by other users. Only returned if @[recursive] is set. - //! @value LOCK_EXCL_BELOW (6) + //! by other users. Only returned if @[recursive] is set. (4) + //! @value LOCK_EXCL_BELOW   //! There are one or more exclusive locks held by other   //! users somewhere below @[path] (but not on @[path] - //! itself). Only returned if @[recursive] is set. - //! @value LOCK_EXCL_AT (7) + //! itself). Only returned if @[recursive] is set. (6) + //! @value LOCK_EXCL_AT   //! There are one or more exclusive locks held by other - //! users on @[path]. + //! users on @[path]. (7)   //! @endint   //! Note that the lowest bit is set for all flags that apply to   //! @[path] itself.   //! @endmixed   //!   //! @note   //! @[DAVLock] objects may be created if the filesystem has some   //! persistent storage of them. The default implementation does not   //! store locks persistently.   //!
Roxen.git/server/base_server/module.pike:972:    }    }    });       SIMPLE_TRACE_LEAVE("Returning %O.", locked_by_auth_user ? LOCK_OWN_BELOW : shared);    return locked_by_auth_user ? LOCK_OWN_BELOW : shared;   }      //! Register @[lock] on the path @[path] under the assumption that   //! there is no other lock already that conflicts with this one, i.e. - //! that @code{check_locks(path,lock->recursive,id)@} would return + //! that @expr{check_locks(path,lock->recursive,id)@} would return   //! @expr{LOCK_NONE@} if @expr{lock->lockscope@} is   //! @expr{"DAV:exclusive"@}, or @expr{< LOCK_OWN_BELOW@} if   //! @expr{lock->lockscope@} is @expr{"DAV:shared"@}.   //!   //! This function is only provided as a helper to call from   //! @[lock_file] if the default lock implementation is to be used.   //!   //! @param path   //! Normalized path (below the filesystem location) that the lock   //! applies to.
Roxen.git/server/base_server/module.pike:1069:    }    if (!sizeof (file_locks[path])) m_delete (file_locks, path);    }    ASSERT_IF_DEBUG (lock /*%O*/ == removed_lock /*%O*/, lock, removed_lock);    TRACE_LEAVE("Ok.");    return 0;   }      //! Register @[lock] on the path @[path] under the assumption that   //! there is no other lock already that conflicts with this one, i.e. - //! that @code{check_locks(path,lock->recursive,id)@} would return + //! that @expr{check_locks(path,lock->recursive,id)@} would return   //! @expr{LOCK_NONE@} if @expr{lock->lockscope@} is   //! @expr{"DAV:exclusive"@}, or @expr{<= LOCK_SHARED_AT@} if   //! @expr{lock->lockscope@} is @expr{"DAV:shared"@}.   //!   //! The implementation must at least support the @expr{"DAV:write"@}   //! lock type (RFC 2518, section 7). Briefly: An exclusive lock on a   //! file prohibits other users from changing its content. An exclusive   //! lock on a directory (aka collection) prohibits other users from   //! adding or removing files or directories in it. An exclusive lock   //! on a file or directory prohibits other users from setting or
Roxen.git/server/base_server/module.pike:2061:   //!   //! You can use @[create_sql_tables] instead of this function if you want   //! to create more than one table in one go.   //!   //! If @[flag] is true, return 1 if a table was created, and 0 otherwise.   //!   //! In the first form, @[name] is the (postfix of) the name of the   //! table, and @[types] is an array of definitions, as an example:   //!   //! - //! @code{ + //! @code   //! cache_table = get_my_table( "cache", ({   //! "id INT UNSIGNED AUTO_INCREMENT",   //! "data BLOB",   //! }) ); - //! @} + //! @endcode   //!   //! In the second form, the whole table definition is instead sent as   //! a string. The cases where the name is not included (the third and   //! fourth form) is equivalent to the first two cases with the name ""   //!   //! If the table does not exist in the datbase, it is created.   //!   //! @note   //! This function may not be called from create   //