Difference between revisions of "Admin Module"
Jump to navigation
Jump to search
m (Text replacement - "'''Signatures'''" to "'''Signature'''") |
|||
Line 11: | Line 11: | ||
{| width='100%' | {| width='100%' | ||
|- valign="top" | |- valign="top" | ||
− | | width='120' | ''' | + | | width='120' | '''Signature''' |
|<pre>admin:logs( | |<pre>admin:logs( | ||
$date as xs:string := () | $date as xs:string := () | ||
Line 33: | Line 33: | ||
{| width='100%' | {| width='100%' | ||
|- valign="top" | |- valign="top" | ||
− | | width='120' | ''' | + | | width='120' | '''Signature''' |
|<pre>admin:write-log( | |<pre>admin:write-log( | ||
$text as xs:string | $text as xs:string | ||
Line 50: | Line 50: | ||
{| width='100%' | {| width='100%' | ||
|- valign="top" | |- valign="top" | ||
− | | width='120' | ''' | + | | width='120' | '''Signature''' |
|<pre>admin:delete-logs( | |<pre>admin:delete-logs( | ||
$date as xs:string | $date as xs:string | ||
Line 68: | Line 68: | ||
{| width='100%' | {| width='100%' | ||
|- valign="top" | |- valign="top" | ||
− | | width='120' | ''' | + | | width='120' | '''Signature''' |
|<pre>admin:sessions() as element(session)*</pre> | |<pre>admin:sessions() as element(session)*</pre> | ||
|- valign="top" | |- valign="top" |
Revision as of 15:02, 9 March 2023
This XQuery Module contains functions for performing admin-centric operations such as managing database users and log data.
Contents
Conventions
All functions and errors in this module are assigned to the http://basex.org/modules/admin
namespace, which is statically bound to the admin
prefix.
Database Logs
admin:logs
Signature | admin:logs( $date as xs:string := () $merge as xs:boolean := () ) as element()* |
Summary | Returns Logging data compiled by the database or HTTP server:
|
Examples |
|
admin:write-log
Signature | admin:write-log( $text as xs:string $type as xs:string := () ) as empty-sequence() |
Summary | Writes a string to the database logs, along with current user data (timestamp, username). An optional log $type can be specified. If omitted, the log type is INFO .If the function is called from a database client, the IP will be logged. Otherwise, the string SERVER will be logged.
|
Errors | type : Type string contains whitespaces.
|
admin:delete-logs
Signature | admin:delete-logs( $date as xs:string ) as empty-sequence() |
Summary | Deletes the log entries from the specified $date
|
Errors | today : Today's log file cannot be deleted.delete : An error occurred while deleting a log file.
|
Database Sessions
admin:sessions
Signature | admin:sessions() as element(session)* |
Summary | Returns an element sequence with all currently opened database sessions, including the username, address (IP:port) and an optionally opened database. The output of this function and the SHOW SESSIONS command is similar.
|
Examples |
|
Errors
Code | Description |
---|---|
delete
|
An error occurred while deleting a log file. |
today
|
Today's log file cannot be deleted. |
type
|
Type string contains whitespaces. |
Changelog
- Version 9.2
- Updated:
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
: optional log type added
- Version 8.2
- Added:
admin:delete-logs
- Version 8.0
- Added:
admin:write-log
- Deleted: admin:users (renamed to
user:list-details
).
- Version 7.8.2
- Updated:
admin:users
: md5-encoded password added to output. - Updated:
admin:logs
: represent name of log files as string value;$merge
argument added.
The Module was introduced with Version 7.5.