Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
→admin:write-log
=Conventions=
All functions and errors in this module are assigned to the <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><nowiki>http://basex.org/errors</nowiki></code> 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 {{Command|SHOW SESSIONS}} command is similar.
|-
| '''Examples'''
==admin:write-log==
{{Mark|Updated with Version 9.2:}} Type string may contain more alphanumeric characters.
{| width='100%'
|-
| '''Summary'''
|Writes a string to the database logs, along with current user data (timestamp, user name). An optional log {{Code|$type}} can be specified, which must consist of letters in upper case. 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.
|-
| '''Errors'''
|{{Error|BXAD0003type|#Errors}} Log type must consist of uppercase lettersType string contains whitespaces.
|}
|-
| '''Errors'''
|{{Error|BXAD0001today|#Errors}} Today's log file cannot be deleted.<br/>{{Error|BXAD0002delete|#Errors}} An error occurred while deleting a log file.
|}
|Description
|-
|{{Code|BXAD0001delete}}|An error occurred while deleting a log file.|-|{{Code|today}}
|Today's log file cannot be deleted.
|-
|{{Code|BXAD0002type}}|An error occurred while deleting a log file.|-|{{Code|BXAD0003}}|Log type must consist of uppercase lettersType 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
