# 22. Virtuoso Functions Guide - WebDAV Users & Groups administration

Chapter Contents | Prev | Next
Keyword Search:
www.openlinksw.com
docs.openlinksw.com
Book Home
Contents
Preface
Virtuoso Functions Guide
Administration
Aggregate Functions
Array Manipulation
BPEL APIs
Backup
Compression
Cursor
Date & Time Manipulation
Debug
Dictionary Manipulation
Encoding & Decoding
File Manipulation
Free Text
Hashing / Cryptographic
LDAP
Locale
Mail
Miscellaneous
Number
Remote SQL Data Source
Replication
SOAP
SQL
String
Transaction
Type Mapping
UDDI
User Defined Types & The CLR
Virtuoso Java PL API
Virtuoso Server Extension Interface (VSEI)
Web Server & Internet
dav add & update fun...
dav manipulation fun...
dav search functions
dav_exp
lfs_exp
serv_queue_top
vhost_define
vhost_remove
webdav users & group...
client_attr
connection_get
connection_id
connection_is_dirty
connection_set
connection_vars
connection_vars_set
dbname
ftp_get
ftp_ls
ftp_put
get_certificate_info
get_keyword
get_keyword_ucase
http
http_acl_get
http_body_read
http_client
http_client_ip
http_debug_log
http_enable_gz
http_file
http_flush
http_get
http_header
http_header_get
http_kill
http_listen_host
http_map_get
http_map_table
http_param
http_path
http_pending_req
http_physical_path
http_proxy
http_request_get
http_request_header
http_request_status
http_rewrite
http_root
http_url
http_value
http_xslt
ses_connect
ses_disconnect
ses_read_line
ses_write
tcpip_gethostbyaddr
tcpip_gethostbyname
vsp_calculate_digest
wsdl_import_udt
XML
XPATH & XQUERY
Functions Index

## WebDAV Users & Groups administration

Functions for manipulating an existing DAV collection or resource
integer DAV_ADD_GROUP (in gid varchar, in auth_uid varchar, in auth_pwd varchar);
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_GROUP (in gid 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);
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
email – User's email
auth_uid – Administration user capable of performing the operation. Default is null.
auth_pwd – Password of Administrator. Default is null.
Errors

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
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');

See Also

DAV content add/update/delete functions

DAV content manipulation functions

DAV lock manipulation functions

DAV search functions