=Conventions=
All functions and errors in this module are assigned to the {{Code|<code><nowiki>http://basex.org/modules/admin}} </nowiki></code> namespace, which is statically bound to the {{Code|admin}} prefix.<br/>All errors are assigned to the {{Code|http://basex.org/errors}} namespace, which is statically bound to the {{Code|bxerr}} prefix.
=FunctionsDatabase Logs= ==admin:sessions== {| width='100%'|-| width='120' | '''Signatures'''|{{Func|admin:sessions||element(session)*}}|-| '''Summary'''|Returns an element sequence with all currently opened sessions, including the user name, address (IP:port) and an optionally opened database.<br/>The output of this function and the [[Commands#SHOW_SESSIONS|SHOW SESSIONS]] command is similar.|-| '''Examples'''|* {{Code|admin:sessions()}} may e.g. return <code><session user="admin" address="127.0.0.1:6286" database="factbook"/></code>|}
==admin:logs==
{| width='100%'
|-valign="top"| width='120' | '''SignaturesSignature'''|{{Func|admin:logs||element(file)*}}<br/pre>{{Func|admin:logs|( $date as xs:string|element := (entry)*}}<br/>{{Func|admin:logs|$date as xs:string, $merge as xs:boolean|? := false()) as element(entry)*}}<br/pre>|-valign="top"
| '''Summary'''
|Returns [[Logging]] data compiled by the database or HTTP server:
* If no argument is specified, a list of all log files will be returned, including the file size and date.
* If a {{Code|$date}} is specified, the contents of a single log file will be returned.
* If {{Code|$merge}} is set to true, related log entries will be merged. Please note that the merge might The merged representation may not be 100% successfulcorrect, as log entries may can be ambiguous.|-valign="top"
| '''Examples'''
|
{| width='100%'
|-valign="top"| width='120' | '''SignaturesSignature'''|<pre>admin:write-log( $message as xs:string, $type as xs:string := ()) as empty-sequence()</pre>|- valign="top"| '''Summary'''|Writes a log {{Code|$message}} to the database logs, along with current user data (timestamp, username). An optional log {{Code|$type}} can be specified. If omitted, the log type is {{Code|INFO}}.<br/>If the function is called from a database client, the IP will be logged. Otherwise, the string {{Code|SERVER}} will be logged.|- valign="top"| '''Errors'''|{{FuncError|type|#Errors}} Type string contains whitespaces.|} ==admin:writedelete-logs== {| width='100%'|-logvalign="top"| width='120' | '''Signature'''|<pre>admin:delete-logs( $text date as xs:string|) as empty-sequence()</pre>|- valign="top"| '''Summary'''|Deletes the log entries from the specified <code>$date</code>|- valign="top"| '''Errors'''|{{Error|today|#Errors}} Today's log file cannot be deleted.<br/>{{Error|delete|#Errors}}An error occurred while deleting a log file.|} =Database Sessions= ==admin:sessions== {| width='100%'|-valign="top"| width='120' | '''Signature'''|<pre>admin:sessions() as element(session)*</pre>|- valign="top"
| '''Summary'''
|Writes a string to Returns an element sequence with all currently opened database sessions, including the database logsusername, along with current user data address (timestamp, user nameIP:port)and an optionally opened database. If <br/>The output of this function and the function {{Command|SHOW SESSIONS}} command is called in similar.|- valign="top"| '''Examples'''|* {{Code|admin:sessions()}} may e.g. return <code><session user="admin" address="127.0.0.1:6286" database="factbook"/></code>|} =Errors= {| class="wikitable" width="100%"! width="110"|Code|Description|- valign="top"|{{Code|delete}}|An error occurred while deleting a web application or a database client, the IP will log file.|- valign="top"|{{Code|today}}|Today's log file cannot be loggeddeleted. Otherwise, the string |- valign="top"|{{Code|STANDALONEtype}} will be logged|Type string contains whitespaces.
|}
=Changelog=
;Version 9.2
* Updated: {{Function||admin:write-log}}: type string may contain more characters
;Version 9.0
* Updated: error codes updated; errors now use the module namespace
;Version 8.3
* Updated: {{Function||admin:write-log}}: optional log type added
;Version 8.2
* Added: {{Function||admin:delete-logs}}
;Version 8.0
* Added: [[#admin:write-log{{Function||admin:write-log]]}}* Deleted: admin:users (renamed to [[{{Function|User Module#user:list-details|user:list-details]]}}).
;Version 7.8.2
* Updated: [[#admin:users{{Function||admin:users]]}}: md5-encoded password added to output.* Updated: [[#admin:logs{{Function||admin:logs]]}}: represent name of log files as string value; {{Code|$merge}} argument added.
The Module was introduced with Version 7.5.
[[Category:XQuery]]