Name
DAV_ADD_USER , DAV_DELETE_USER , DAV_HOME_DIR , DAV_ADD_GROUP , DAV_DELETE_GROUP — Functions for manipulating an existing DAV collection or resource
Synopsis
integer
DAV_ADD_USER
(
|
in uid varchar , |
| in pwd varchar , | |
| in gid varchar , | |
| in permis varchar , | |
| in disable integer , | |
| in home varchar , | |
| in full_name varchar , | |
| in email varchar , | |
| in uid varchar , | |
| in auth_uid varchar , | |
in
auth_pwd
varchar
); |
varchar
DAV_DELETE_USER
(
|
in uid varchar , |
| in auth_uid varchar , | |
in
auth_pwd
varchar
); |
varchar
DAV_HOME_DIR
(
|
in
uid
varchar
); |
integer
DAV_ADD_GROUP
(
|
in gid varchar , |
| in auth_uid varchar , | |
in
auth_pwd
varchar
); |
varchar
DAV_DELETE_GROUP
(
|
in gid varchar , |
| in auth_uid varchar , | |
in
auth_pwd
varchar
); |
Description
DAV_ADD_USER() create a new WebDAV user with login name 'uid' and password 'pwd'. User will belong to the group named 'gid'. 'perms' are the default user permissions for creation of new resources. Additional user info supplied is 'home' directory, 'full name' and 'e-mail'.
DAV_DELETE_USER() remove the existing webDAV user named 'uid'.
DAV_HOME_DIR() returns the home folder for specified WebDAV user named 'uid'.
DAV_ADD_GROUP() create a new webDAV group named 'gid'.
DAV_DELETE_GROUP() remove the existing webDAV group named 'gid'.
Parameters
uid
User identifier. Default is 'dav'.
pwd
Password
gid
Group identifier. Default is 'dav'.
perms
Permissions
disable
Disable flag
home
The User's home directory path
full_name
Full name of user
User's email
auth_uid
Administration user capable of performing the operation. Default is null.
auth_pwd
Password of Administrator. Default is null.
Errors
Table 24.21. Errors signalled by DAV_* functions
| Error Code | Description |
|---|---|
| >=0 | success |
| -1 | The path (target of operation) is not valid |
| -2 | The destination (path) is not valid |
| -3 | Overwrite flag is not set and destination exists |
| -4 | The target is resource, but source is collection (in copy move operations) |
| -5 | Permissions are not valid |
| -6 | uid is not valid |
| -7 | gid is not valid |
| -8 | Target is locked |
| -9 | Destination is locked |
| -10 | Property name is reserved (protected or private) |
| -11 | Property does not exists |
| -12 | Authentication failed |
| -13 | Operation is forbidden (the authenticated user do not have a permissions for the action) |
| -14 | the target type is not valid |
| -15 | The umask is not valid |
| -16 | The property already exists |
| -17 | Invalid property value |
| -18 | no such user |
| -19 | no home directory |
Examples
Example 24.80. WebDAV users operations
The example will create a WebDAV user named 'davuser' belongs to the group 'davgroup'. No home directory supplied. The user account is enabled after operaion.
SQL> DB.DBA.DAV_ADD_GROUP ('davgroup', 'dav', 'dav');
SQL> DB.DBA.DAV_ADD_USER ('davuser', 'secret', 'davgroup', '110100000', 0, NULL, 'Test User Account', 'nobody@foo.bar', 'dav', 'dav');