Oracle9i Supplied PL/SQL Packages and Types Reference Release 2 (9.2) Part Number A96612-01 |
|
DBMS_XDB, 2 of 2
Retrieves ACL document that protects resource given its pathname; returns the xmltype
for ACL document.
FUNCTION getAclDocument( abspath IN VARCHAR2) RETURN sys.xmltype;
Parameter | IN / OUT | Description |
---|---|---|
abspath |
(IN) |
Pathname of the resource whose ACL doc is required. |
Gets all privileges granted to the current user on the given XDB resource. Returns an XMLType instance of <privilege> element, which contains the list of all leaf privileges granted on this resource to the current user. For example,
<privilege xmlns="http://xmlns.oracle.com/xdb/acl.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.oracle.com/xdb/acl.xsd http://xmlns.oracle.com/xdb/acl.xsd" <read-contents/> <read-properties/> <resolve/> <read-acl/> </privilege>
FUNCTION getPrivileges( res_path IN VARCHAR2) RETURN sys.xmltype;
Parameter | IN / OUT | Description |
---|---|---|
res_path |
(IN) |
Absolute path in the Hierarchy of the XDB resource. |
Adds the given ACE to the given resource's ACL. Returns positive integer if ACL was successfully modified. For example,
<ace xmlns="http://xmlns.oracle.com/xdb/acl.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:dav="DAV:" xsi:schemaLocation="http://xmlns.oracle.com/xdb/acl.xsd http://xmlns.oracle.com/xdb/acl.xsd DAV:http://xmlns.oracle.com/xdb/dav.xsd" <grant>true</grant> <principal>SCOTT</principal> <privilege> <read-contents/> <read-properties/> <resolve/> <dav:waste/> </privilege> </ace>
FUNCTION changePrivileges( res_path IN VARCHAR2, ace IN xmltype) RETURN pls_integer;
If no ACE with the same principal and the same operation (grant
/deny
) already exists in the ACL, the new ACE is added at the end of the ACL.
Checks access privileges granted to the current user on the specified XDB resource. Returns positive integer if all requested privileges granted. For example, check for <read.contents>
, <read.properties>
and <dav:waste>
privileges using the following <privilege>
XMLType instance.
<privilege xmlns="http://xmlns.oracle.com/xdb/acl.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:dav="DAV:" xsi:schemaLocation="http://xmlns.oracle.com/xdb/acl.xsd http://xmlns.oracle.com/xdb/acl.xsd DAV: http://xmlns.oracle.com/xdb/dav.xsd" <read-contents/> <read-properties/> <resolve/> <dav:waste/> </privilege>
FUNCTION checkPrivileges( res_path IN VARCHAR2, privs IN xmltype) RETURN pls_integer;
Sets the ACL on the given XDB resource to be the ACL specified by path. The user must have <write-acl>
privileges on the resource.
PROCEDURE setacl( res_path IN VARCHAR2, acl_path IN VARCHAR2);
Parameter | IN / OUT | Description |
---|---|---|
res_path |
(IN) |
Absolute path in the Hierarchy for XDB resource. |
acl_path |
(IN) |
Absolute path in the Hierarchy for XDB ACL. |
Checks access privileges granted to the current user by specified ACL document on a resource whose owner is specified by the 'owner' parameter. Returns positive integer if all requested privileges granted.
FUNCTION AclCheckPrivileges( acl_path IN VARCHAR2, owner IN VARCHAR2, privs IN xmltype) RETURN pls_integer;
Given a path to a resource, gets a WebDAV-style lock on that resource. Returns TRUE
if operation successful; FALSE
, otherwise. The user must have UPDATE
privileges on the resource.
FUNCTION LockResource( path IN VARCHAR2, depthzero IN BOOLEAN, shared IN boolean) RETURN BOOLEAN;
Given a path to a resource, returns that resource's lock token for the current user. The user must have READPROPERTIES
privilege on the resource.
PROCEDURE GetLockToken( path IN VARCHAR2, locktoken OUT VARCHAR2);
Parameter | IN / OUT | Description |
---|---|---|
path |
(IN) |
Path name to the resource. |
locktoken |
(OUT) |
Logged-in user's lock token for the resource. |
Unlocks the resource given a lock token and a path to the resource. Returns TRUE
if operation successful; FALSE
, otherwise. The user must have UPDATE
privileges on the resource.
FUNCTION UnlockResource( path IN VARCHAR2, deltoken IN VARCHAR2) RETURN BOOLEAN;
Parameter | IN / OUT | Description |
---|---|---|
path |
(IN) |
Path name to the resource. |
deltoken |
(IN) |
Lock token to be removed. |
Creates a new resource. Returns TRUE
if operation successful; FALSE
, otherwise.The options are described in the following table.
Creates a new folder resource in the hierarchy. Returns TRUE
if operation successful; FALSE
, otherwise. The given path name's parent folder must already exist in the hierarchy, i.e. if '/folder1/folder2'
is passed as the path parameter, then '/folder1'
must already exist.
FUNCTION CreateFolder( path IN VARCHAR2) RETURN BOOLEAN;
Parameter | IN / OUT | Description |
---|---|---|
path |
(IN) |
Path name for the new folder. |
Deletes a resource from the hierarchy.
PROCEDURE DeleteResource( path IN VARCHAR2);
Parameter | IN / OUT | Description |
---|---|---|
path |
(IN) |
Path name of the resource to delete. |
Creates a link to an existing resource. This procedures is analogous to creating a hard link in UNIX.
PROCEDURE Link( srcpath IN VARCHAR2, linkfolder IN VARCHAR2, linkname IN VARCHAR2);
Parameter | IN / OUT | Description |
---|---|---|
srcpath |
(IN) |
Path name of the resource to which a link is made |
linkfolder |
(IN) |
Folder in which the new link is placed. |
linkname |
(IN) |
Name of the new link. |
Refreshes the session's configuration information to the latest configuration.
PROCEDURE CFG_Refresh;
Retrieves the session's configuration information as an XMLType instance.
FUNCTION CFG_Get RETURN SYS.XMLType;
Updates the configuration information and commits the change.
PROCEDURE CFG_Update( xdbconfig IN SYS.XMLTYPE);
Parameter | IN / OUT | Description |
---|---|---|
xdbconfig |
(IN) |
The new configuration data. |
|
Copyright © 2000, 2002 Oracle Corporation. All Rights Reserved. |
|