Changes

Jump to navigation Jump to search
1,132 bytes added ,  14:47, 16 April 2019
=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.
=Functions=
|-
| '''Summary'''
|Returns an element sequence with all currently opened database sessions, including the user name, address (IP:port) and an optionally opened database.<br/>The output of this function and the [[Commands#SHOW_SESSIONS{{Command|SHOW SESSIONS]] }} command is similar.
|-
| '''Examples'''
| '''Examples'''
|
* {{Code|admin:logs()}} may return <code><file size="834367"/>20132015-01-23</file></code> if a single log file exists.
* {{Code|admin:logs() ! admin:logs(.)}} lists the contents of all log files.
|}
==admin:write-log==
{{Mark|Introduced Updated with Version 89.02:}}:Type string may contain more alphanumeric characters.
{| width='100%'
|-
| width='120' | '''Signatures'''
|{{Func|admin:write-log|$text as xs:string|empty-sequence()}}<br/>{{Func|admin:write-log|$text as xs:string, $type as xs:string|empty-sequence()}}
|-
| '''Summary'''
|Writes a string to the database logs, along with current user data (timestamp, user name). An optional log {{Code|$type}} can be specified. If omitted, the log type is {{Code|INFO}}.<br/>If the function is called in a web application or from a database client, the IP will be logged. Otherwise, the string {{Code|STANDALONESERVER}} will be logged.|-| '''Errors'''|{{Error|type|#Errors}} Type string contains whitespaces.|} ==admin:delete-logs== {| width='100%'|-| width='120' | '''Signatures'''|{{Func|admin:delete-logs|$date as xs:string|empty-sequence()}}|-| '''Summary'''|Deletes the log entries from the specified <code>$date</code>|-| '''Errors'''|{{Error|today|#Errors}} Today's log file cannot be deleted.<br/>{{Error|delete|#Errors}} An error occurred while deleting a log file.|} =Errors= {| class="wikitable" width="100%"! width="110"|Code|Description|-|{{Code|delete}}|An error occurred while deleting a log file.|-|{{Code|today}}|Today's log file cannot be deleted.|-|{{Code|type}}|Type string contains whitespaces.
|}
=Changelog=
 
;Version 9.2
 
* Updated: [[#admin:write-log|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: [[#admin:write-log|admin:write-log]]: optional log type added
 
;Version 8.2
 
* Added: [[#admin:delete-logs|admin:delete-logs]]
;Version 8.0
The Module was introduced with Version 7.5.
 
[[Category:XQuery]]
Bureaucrats, editor, reviewer, Administrators
13,550

edits

Navigation menu